This will overwrite the current preset. Are you sure?
Please type a name for your preset, or press 'load' on any of the
presets below to edit.
Error: If you selected 'Require terms' you must select 'Include'
and/or select at least two terms.
Error: If you selected 'Require Taxonomy' you must select 'Include'
and/or select at least two terms. If the current page does not have
any terms in this taxonomy. The post list may not display anything.
Error: No other taxonomies are being used within the post_type.
Cannot use (< > : \" / \\ | ? *).
Please rename your filename.
Post Types - Each (jQuiry UI) accordion contains a
separate individual post type. The default post types built into WordPress
are Post and Page. Any additional post types are dynamically added in
the manner WordPress does. Please Note: Each post/page can have only
one post type, which may explain why it has been divided by post types.
Post Parent – Each hierarchical post type has a Parent
selector for selecting which children pages to display. You can add
multiple Post Parents of dynamically add children pages according to
the Current Page.
Current Page – If selected, the post list will include
children pages from the current page being viewed.
Taxonomies – Each taxonomy is generally spit up in two
sections, and divided into separate tabs. Hierarchies (categories) are
located on the left, and non-hierarchies (tags) are located on the right.
Require Taxonomy - If more than one ‘Require Taxonomy’
is checked and terms (or include) are selected, or 'any', then each
taxonomy must be required within the post type.
Require Terms - If selected, and more than one term
is checked, then each term must be required within the CPT/taxonomy
in order to be displayed in the post list.
Include Terms – If selected, the post list preset
will include any terms the current page/post has within the CTP/taxonomy.
Any - When checked, any terms will be included within
that CPT/taxonomy.
Posts Status - Holds the settings to show which posts
to display based on the user visibility and/or the page states. To which
is only visible to the users with the necessary capabilities to view
them.
- Visibility - Display posts as either Public,
Private, or Both.
- Status States - Choose from Published, Future,
Pending Review, Draft, Auto-save, Inherit, and/or Trash.
List Amount - The numeric value of how many posts
you want the post list to display. Negative one (-1) will display
all the posts that are available after filtering.
Author Filter - Show or remove posts that were created
by a certain author, or authors. You can only choose between adding or
removing, not both.
- Operator - Determines whether you want to include
or exclude authors.
- Author Names/IDs - Displays a list of authors the
site currently has and is divided/grouped into separate role groups.
Order By - Choose which page properties to sort from.
All of which are built in params used in WP_Query.
Perm - Uses the user permission via. user
capabilities to determine what posts to display in the post list
to the visitor/user.
Ignore Sticky Posts - Meant for the built-in post type
(Posts) function. When checked, this will prevent sticky posts from
always displaying at the top of the post list.
Exclude Current Post - When checked, the current post
being viewed will be excluded from the post list.
Exclude Posts by ID - Add post/page IDs, seperated by
a comma (,), will prevent those posts from being added to the post list.
Exclude Duplicates from Current Post - In the 'order
that it is received', each preset post list being viewed will add
the post IDs to a global exclude list built into APL. When checked,
the preset post list will add the post IDs (listed at the time) to the
exclude filter settings in WP_Query. This will remove any posts that
have already been displayed to the user by the APL plugin.
Empty Message - This container holds the HTML & CSS content
and if no posts are found to be listed in the preset. Then the preset post list will display
this message. If no Empty Message is found, then the post list will use
the Default Empty Message if enabled in the Plugin's Admin Settings.
Otherwise, the plugin will display nothing like it was originally set as.
Please Note: if you are using the Default Empty Message but you
don't want to display anything in a certain preset post list. Then simple
create an empty element to fall back on. For example, an empty 'span' HTML element.
Before List - Used to store any HTML & CSS code that
exists before the post/content listings. Useful for div, ul, ol,
tables, etc.. As well as storing CSS styling for IDs and Classes.
List Content - This where you design how your posts
are going to display in the post list. In here you can use HTML, CSS,
PHP (requires the PHP shortcode), and the plugin's internal
shortcodes. Info can be found at the bottom, or by clicking on the
shortcode info found below "List content".
After List - Used for ending any elements that are
still open, or to display a final message to the users/visitors.
Shortcodes: Use these codes inside the list item content (will
throw errors if placed in before or after HTML fields).
- [ID] - the ID number of the page/post
- [post_author label="display_name"] - post author information. Possible types: ID, user_login, user_pass, user_nicename, user_email, user_url, display_name, user_firstname, user_lastname, nickname, description, primary_blog
- [post_permalink] - the page permalink
- [post_date format="m-d-Y"] - date page/post was created *
- [post_date_gmt format="m-d-Y"] - date page/post was created in gmt time *
- [post_title] - page/post title
- [post_content] - page/post content
- [post_excerpt length="250"] - page/post excerpt (note the optional character 'length' parameter)
- [post_name] - page/post slug name
- [post_modified format="m-d-Y"] - date page/post was last modified *
- [post_modified_gmt format="m-d-Y"] - date page/post was last modified in gmt time *
- [guid] - original URL of the page/post (post_permalink is probably better)
- [comment_count] - number of comments posted for this post/page
- [item_number offset="1" increment="1"] - the list index for each page/post. Offset parameter sets start position. Increment sets the number you want to increase on each loop.
- [final_end] - on the final list item, everything after this shortcode will be excluded. This will allow you to have commas (or anything else) after each item except the last one.
- [post_pdf] - URL to the page/post's PDF file. (Requires Kalin's PDF Creation Station plugin. See help menu for more info.)
- [post_meta name="custom_field_name"] - page/post custom field value. Correct 'name' parameter required
- [post_tags delimeter=", " links="true"] - post tags list. Optional 'delimiter' parameter sets separator text. Use optional 'links' parameter to turn off links to tag pages
- [post_categories delimeter=", " links="true"] - post categories list. Parameters work like tag shortcode.
- [post_terms taxonomy="category" delimiter=", " links="true" max="0" empty_message=""] - displays a list of post/page terms list. Required/Optional 'taxonomy' parameter sets what taxonomy terms to return; uses taxonomy slug as param value. Optional 'delimiter' parameter sets separator text. Optional 'links' parameter to turn off links to term pages/permalinks. Optional 'max' parameter to set the maximum amount of terms to list; Values Zero or less are infinite values. Optional 'empty_message' parameter to set a custom message to return if none of the taxonomy's terms exist in the post/page.
- [post_parent link="true"] - post parent. Use optional 'link' parameter to turn off link
- [post_comments before="" after=""] - post comments. Parameters represent text/HTML that will be inserted before and after comment list but will not be displayed if there are no comments. PHP coders: learn how to customize comment display (kalinbooks site).
- [post_thumb size="full" extract="none"] - URL to the page/post's featured image (requires theme support). Possible size paramaters: "thumbnail", "medium", "large" or "full". Possible xtract prameters: "on" or "force". Setting extract to "on" will cause the shortcode to attempt to pull the first image from within the post if it cannot find a featured image. Using "force" will cause it to ignore the featured image altogether. Extracted images always return at the same size they appear in the post.
- [php_function name="function_name" param=""] - call a user-defined custom function. Refer to this blog post (kalinbooks site) for instructions.
* Time shortcodes have an optional format parameter. Format your
dates using these possible tokens: m=month, M=text month, F=full text
month, d=day, D=short text Day Y=4 digit year, y=2 digit year, H=hour,
i=minute, s=seconds. More tokens listed here:
http://php.net/manual/en/function.date.php.
Note: these shortcodes only work in the List item content box on this page.
*/
?>
Eventually this feature will be changed to provide a more accurate
preview of the post list and will be more balanced on the on the admin
page. Currently, the preview feature has difficulty displaying private
posts and displaying posts with a preset post list with dynamic features
(Current Page & Include Terms). The current query uses the current page
that you are viewing, and from the admin page, it provides limited results.
Later on, this feature will be changed to view the post list as if it
were on the selected page you want to preview from (only the post list
will display). As well as creating a dialog for it, which may or may not
have width & height params for the admin to utilize.
A more practical use to get an accurate preview just create a test
page/post to use to display the preset shortcode. Private posts will
show up in there, and dynamic features can be utilize. Of course, that
depends on how your test page/post is set up.
General Plugin Settings - Controls the basic core/global
settings and actions of the plugin, and the admin section.
Delete Database Upon Deactivation - If 'No' is selected,
then the plugin's database data will not be removed when the plugin is
deactivated. When re-activated, the plugin data will restored as it
was left. Please Note: If the plugin is removed/uninstalled,
then the plugin's data will be removed regardless.
Admin jQuery UI Theme - Added as a simple extra to
change the appearance that the jQuery UI will display as.
Enable Default Empty Message - Used as a default option
to use if no posts are found and the Empty Message is empty within the
preset post list.
- Enable Global Exit (boolean) - If enabled (yes),
the all presets will fallback on the global/default Empty Message.
- Empty Message - Contains the message that will be
displayed if no posts are found. HTML and CSS can be used.
Preset Database Tools - Tools for backing up, restoring,
or adding additional presets to the APL preset database. You can also
export/download individual presets simular to exporting the preset table.
If you'd like to share some of your own presets, then read these
Guidelines/Instructions for Submitting Presets
for more information.
Export Preset Table - Exports the whole APL preset
database/table. Illegal (< > : " / \ | , ? *) characters cannot be used
as the exported filename.
Import Preset(s) - Imports one or more presets, from
a 2 different sources, and is added to the database. Any older versions,
including Kalin's Post List (KPL), will automatically be upgraded, but
is limited to any versions higher than the current APL version being used.
- Upload (file) - Imports one or more presets, from
a JSON file, and is added to the database. You can either import your
own, or download presets shared in the
Preset Exchange
community.
- Kalin's Post Lists (KPL) Database - Import/migrate data from KPL,
the original/older plugin, into APL's preset database.
Restore Preset Defaults - Designed to restore only
the default preset table the plugin initially came with.