=== Custom Content Shortcode === Contributors: miyarakira Author: Eliot Akira Author URI: eliotakira.com Plugin URI: wordpress.org/plugins/custom-content-shortcode/ Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=T3H8XVEMEA73Y Tags: loop, query, content, shortcode, post type, field, attachment, comment, sidebar, taxonomy Requires at least: 3.6 Tested up to: 4.3 Stable tag: 2.9.2 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Display posts, pages, custom post types, fields, attachments, comments, images, users, menus, sidebars == Description == = Overview =
From a single field to entire pages, Custom Content Shortcode is a set of commands to display content where you need. The **[content]** shortcode displays any of the following: *posts, pages, custom post types, fields, images, menus,* or *widget areas*. The **[loop]** shortcode performs query loops. It can display, for example, available products in a category, or excerpts from the 5 most recent posts. You can query by parameters such as: *post type, taxonomy, date,* and *field values*. There is a reference section under Settings -> Custom Content. = Included =
Here are some of the included features: * Overview of your site's **content structure** * **Pagination** for post loops * Display **comments** and **attachments** * **User info** and content based on user status * **Relative URLs** for links and images * **Cache** the result of a query * Optional: **Gallery field**, **Mobile Detect** Support for other plugins: * [Advanced Custom Fields](http://wordpress.org/plugins/advanced-custom-fields/) * [WCK Fields and Post Types](http://wordpress.org/plugins/wck-custom-fields-and-custom-post-types-creator/) == Installation == 1. Install & activate from *Plugins -> Add New* 1. See: *Settings -> Custom Content* == Screenshots == 1. Documentation and examples 2. Content overview page 3. Gallery field == Upgrade Notice == == Changelog == = 2.9.2 = * [link] - Add parameters *id* and *name* * [pass array] - Pass values from a field stored as array of key-value pairs * Documentation - Note about displaying Google map field in Optional -> ACF = 2.9.1 = * [field image] - Add parameter *return* to display: *url, id, title, caption, description* * [load] - Improve compatibility for shortcodes in HTML attributes * [loop menu] - Loop through menu items * HTML Blocks module - Add: *dl, dt, dd* = 2.9.0 = * Settings - Option to enable shortcodes in `the_excerpt()` = 2.8.8 = * [array] - Field value stored as JSON object/array: *json=true* * [field] - Featured image and thumbnail have *alt* attribute by default * [if first/last] - Check index of multiple arrays when used with [array] * [if each_field] - Check taxonomy term field inside for/each loop * Settings - Option to deactivate specific shortcodes * Add documentation about shortcode use in PHP template * Improve compatibility for shortcodes in sidebar widgets = 2.8.6 = * [field] - Display ACF field label: *out=field-label* = 2.8.5 = * [content], [field] - Add *texturize* parameter to apply text transformations like smart quotes, apostrophes, dashes, ellipses * [loop taxonomy] - Support post format, for example: *taxonomy=format term=audio* * [loopage anchor] - Add anchor link to the paged URLs * [loopage-prev], [loopage-next] - Display links to previous/next page in loop * [raw], [related] - Minor improvements for reliability = 2.8.4 = * Compatibility with WP 4.3 for shortcodes in Visual Editor = 2.8.3 = * [user archive-url] - User posts archive URL * [user archive-link] - Display name linked to user posts archive = 2.8.2 = * [if count] - Check current index in loop * [field post-format] - Display post format for current post * [if format] - Check current post format * [image] - Display an image element with URL using shortcodes = 2.8.0 = * [if author] - Check current post by author ID or user name; set to *this* for current user * [the-loop] and [the-pagination] - Default query loop and pagination, for use in templates = 2.7.9 = * [for each] - Add *children* parameter to get all descendants when using *term* or *parent* * [if] - Fix when ACF module is not enabled * [related] - Fix getting posts related by multiple taxonomies * [taxonomy] - Fix predefined field *link* = 2.7.8 = * [field] - Support [ACF Image Crop](https://wordpress.org/plugins/acf-image-crop-add-on/) field; see documentation under Optional -> ACF = 2.7.7 = * [comments] - Add parameter *author* to get comments on posts by author ID or user name * [link] - Generate a link based on field value; see documentation under Main Features -> Field = 2.7.6 = * [raw] - Improve compatibility with Wistia video embed = 2.7.5 = * [attached] - Improve getting current attachment ID * [if] - Add parameters *first* and *every* for ACF repeater field * [related] - Set parameter *children=true* to include posts related by child terms = 2.7.4 = * Continued efforts to improve compatibility for all shortcodes = 2.5.8 = * [for] - Fix *count* parameter to limit number of terms * [today] - Use `date_i18n` for date internationalization = 2.5.6 = * [loop], [field] - Add parameters *escape* and *unescape* * [loop-count] - Output current index of the loop, starting from 1 = 2.5.2 = * [field] - Add predefined field *link* and parameter *link_text*, to encourage not using shortcodes in HTML attributes = 2.5.1 = * Addressing issue with shortcodes inside HTML attributes after WP 4.2.3 update = 2.4.8 = * [if sticky] - Check if post is sticky = 2.4.7 = * [array] - Support looping through multiple selections and available choices for ACF checkbox/select/radio field = 2.4.6 = * [if] - Check if post has excerpt: `[if field=excerpt]` * [loop] - Include sticky post: *sticky=true* = 2.4.4 = * [content], [field] - Trim to last sentence: *sentence=true* * [random] - Display a random integer, for example: `[random 0-99]` * [pass random] - Pass a random integer to a shortcode parameter, for example: `[pass random=0-99]` * [pass global=query] - Pass query variables from the URL = 2.4.1 = * [loop] - Fix parameter *start* to get posts whose field value starts with string * [related] - Get posts related by a taxonomy field: *taxonomy_field=field_name* = 2.4.0 = * [content words] - Display content after X words: *words=-15* * [loop] - Multiple values for single field query: *value=1,2,3* = 2.3.9 = * [comment avatar] - Get comment author's avatar from e-mail; thanks @indrayn! = 2.3.8 = * [content] - Removed infinite loop detection = 2.3.6 = * [pass] - Pass current URL route and its parts: *global="route"* = 2.3.5 = * [repeater] - Display a random row from a repeater field: *row="rand"* = 2.3.4 = * [content] - Detect and prevent infinite loop if showing current post * [flex] - Support nested ACF Flexible Content field = 2.3.3 = * [loop] - Get previous/next post in the loop with [prev] and [next] * [today] - Display today's date * [*] - Place comment in the visual editor * [br], [p] - These will work without HTML Blocks module enabled = 2.3.0 = * [comment template] - Load *comments.php* from theme * [loop fields] - Only field tags specified by the *fields* parameter will be rendered, same as the [pass] shortcode ...