=== Custom Content Shortcode ===
Contributors: miyarakira
Author: Eliot Akira
Author URI: eliotakira.com
Plugin URI: wordpress.org/plugins/custom-content-shortcode/
Tags: custom post type, custom field, shortcode, query, loop
Requires at least: 3.6
Tested up to: 3.8.1
Stable tag: 0.7.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Display posts, pages, custom post types, custom fields, files, images, comments, attachments, menus, or widget areas
== 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, custom fields, files, images, attachments, 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: *date, category, tags, taxonomy,* and *custom field values*.
There is a reference page under *Settings -> Custom Content*, as well as an overview of your site's content structure.
= Included =
You'll find many useful features:
* Simple **gallery field** for any post type
* Include **HTML/PHP/CSS/JavaScript** files
* Selectively display content with **Mobile Detect**
* Display content for **admin, specific user, login status**
* User name, ID, **login/logout links** with redirect
* **Comments** list, input form or comment count
* **Relative URLs** for links and images
With other libraries:
* Display [Bootstrap v3](http://getbootstrap.com/) **carousel**, **navbar menu**, **pills**, **stacked**
* Display [Advanced Custom Fields](http://wordpress.org/plugins/advanced-custom-fields/) - **image**, **gallery**, **repeater**, **flexible content**
* Include [Live Edit](http://wordpress.org/plugins/live-edit/) with a shortcode - **front-end editing** of content and fields
== Installation ==
1. Upload `custom-content-shortcode.zip` through *Plugins->Add New*, or extract and upload the folder to the `/wp-content/plugins/` directory
1. Activate the plugin from the *Plugins* menu
1. Place the shortcode in a post, page, etc.
== Screenshots ==
None.
== Changelog ==
= 0.7.2 =
* **[loop]** - Enable multiple values for post ID, i.e., *id="1,3,7"*
* **[loop]** - Add parameter *exclude* by post ID, i.e., *exclude="7,15,21"*
* **[content]** - Add parameter *more* to display content up to the more tag
* **[content]** - Add field *attach-link* to display image attachment page link
* **[content]** - Process content in correct order: do_shortcode, then wpautop
* **[comment total]** - New parameter to display total comment count of last loop
* **[load]** - Return output instead of echo
* **Gallery Field** - Add all image sizes for parameter *size*
= 0.7.1 =
* **[loop]** - Improved parameter *checkbox* to query by checkbox value(s)
* **[is user]** - Enable multiple values, i.e., *user="1,3,7,guest"*
= 0.7.0 =
* **[content]** - Display correct author name
* **[content]** - Added field *modified* to display date of last post update
* **[loop]** - Added field *parent* (by slug) to display children
* **[loop]** - Improved *orderby="menu_order"*
* **[loop]** - Improved *orderby="modified"*
* Fixed compatibility with a theme
= 0.6.9 =
* **[user]** - User name, id, e-mail, full name, avatar
* **[loop]** - Added parameter *clean="true"* to remove extra *p* and *br* tags
* **[content]** - Added field *title-length*
* **[content]** - Display correct image sizes
* Other minor improvements: performance and content overview page
= 0.6.8 =
* No change in function; improved code so there are no PHP notices when debug is on
= 0.6.5 =
* **[content]** - Add *out=“slug”* to output post taxonomy slug
* **[content]** - Improved check for published status
* **[content]** - Added *post* and *page* parameter, for example: *[content page=“about”]*
= 0.6.4 =
* **[loop]**, **[content]** - Added parameter *status* to filter by post status: *any, publish, pending, draft, future, private*; the default is *publish*
= 0.6.3 =
* Fixed documentation
= 0.6.2 =
* **[loop]** - Added parameter *checkbox* and *checkbox_2*, to query checkbox values
* **[content]** - Added parameter *checkbox* to display checked values
= 0.6.1 =
* **[load]** - Added parameter *dir=“web”*
= 0.6.0 =
* **[content]** - Added *return=“url”* parameter, to return URL of an image; this can be used to set a background image according to a field
* **[content]** - Added *in* parameter, to specify if the image field contains an attachment ID, URL, or object; default is ID
* **[content]** - Added *size* parameter for image size; depending on the theme, you can set *thumbnail*, *medium*, *large*, or custom size
= 0.5.9 =
* Fixed display of shortcode functions in content overview
= 0.5.8 =
* **[content]** - Added *allow* parameter - strips all HTML tags except allowed
= 0.5.7 =
* **[loop]** - Fixed query when field value includes ampersand symbol
= 0.5.6 =
* Content overview: added list of default fields and registered shortcodes
* Reference page: fixed logo when *wp-content* folder has been renamed
= 0.5.5 =
* Content overview: fixed display when there are no fields found
= 0.5.4 =
* **[content]** - post URL field now returns clean permalink structure
= 0.5.3 =
* Improved performance of content overview page
= 0.5.1 =
* Added an overview of site content structure: *Dashboard -> Content*
= 0.5.0 =
* **Mobile Detect** - display content based on device type: *is_phone, isnt_phone, is_tablet, is_mobile, is_computer*
* **[redirect]** - redirect user to another URL: based on login status, device type, etc.
* **[load]** - now able to include files with HTML, PHP script, and shortcodes
* **[content]** - added author ID, URL, avatar
= 0.4.9 =
* Fixed compatibility issue with a theme
= 0.4.8 =
* **[loop]** - Added filter by date: *year*, *month*, *day*
= 0.4.7 =
* Better support for Advanced Custom Fields: gallery, repeater and flexible content - *flex, repeat, layout, sub, sub_image, and acf_gallery*
* Added new pages to reference section
* Fixed display of bullet points in the admin panel
= 0.4.6 =
* Improved reference page under *Settings -> Custom Content*, and simplified *readme.txt* to avoid duplicate content
* **[content]** - Added native gallery parameters: *orderby*, *order*, *columns*, *size*, *link*, *include*, *exclude*
= 0.4.5 =
* **[pass]** - Added *varible* parameter - displayed using {VAR} or {VARIABLE}
* **[loop]** - Made *title* parameter case-insensitive
= 0.4.4 =
* **[loop]** - Added *title* parameter; Added conditional statement: *if="all-no-comments"*
* Better code management (on-going)
* Started reference page
= 0.4.2 =
* **[list_shortcodes]** - Display a list of shortcodes defined
* Fixed compatibility issue with a theme
= 0.3.9 =
* **[loop]** - Added meta query parameters: field, compare, value, relation, field_2, compare_2, value_2
* **[loop]** - Added *strip_tags* parameter to remove `
` and `
` tags inside the loop
* Added **[p]** and **[br]** shortcodes to manually create paragraphs and break lines
= 0.3.8 =
* Added *offset* parameter to offset the query loop by a number of posts, for example: start from the 3rd most recent post
= 0.3.7 =
* Added *date_format* parameter to display post dates in a custom format
= 0.3.6 =
* Fixed one line to be compatible with older versions (<5.3) of PHP
= 0.3.5 =
* Added *series* parameter to order posts by a series of custom field values
= 0.3.4 =
* Added *taxonomy*, *value*, *orderby*, *order*, *meta_key*
* Added *align* parameter - left, center, right
* Fixed fetching repeater subfield from post other than current
= 0.3.3 =
* Changed *format* parameter - only post content is formatted (paragraph tags and line breaks) by default
= 0.3.2 =
* Added *words* and *length* parameters to limit number of words/characters
= 0.3.1 =
* Changed *class* parameter to work on all fields
* Added *ul* parameter to **[content menu]** - ul class to allow Bootstrap or other customization
* Moved **gallery field** settings from Plugins to Settings
* Added ability to override post content with the *html* field
= 0.2.8 =
* Created documentation page
* No change in code
= 0.2.7 =
* Added **[is]** shortcode - display content when user is administrator, non-administrator, logged in, or logged out
* Added *login* and *logout* parameter to **[url]** shortcode - display login/logout link url, also possible to redirect
* Improved the way *css* and *js* fields are loaded when outside the loop
= 0.2.6 =
* Added **[comment]** shortcode for displaying comment count, input form and template
= 0.2.5 =
* Added *gfonts* parameter for loading Google Fonts
= 0.2.4 =
* Added **[url]** shortcode
* Added a few parameters to **[load]** and **[live-edit]** shortcodes
* Added Bootstrap carousel support for *acf_gallery*
* Fixed live-edit when not logged in
* Support for older version of PHP
= 0.2.3 =
* Added support for Advanced Custom Fields: *acf_gallery*
* Added *admin* and *editor* parameters for Live Edit
= 0.2.2 =
* Added **[live-edit]**
= 0.2.1 =
* **[loop]** - Added *x* parameter - repeat content x times
* Added support for Advanced Custom Fields: *repeater*
= 0.2.0 =
* **[load]** - Added *dir* parameter to choose directory
* **[content]** - Added *image* parameter for image fields
* **[content]** - Get specific image from gallery field
= 0.1.9 =
* Added **[navbar]** - Bootstrap navbar menu
= 0.1.8 =
* Cleaned code
* Load *css* and *js* fields into the header/footer
* Added shortcodes: **[css]**, **[js]**, and **[load]**
* Fixed attachment image showing only thumbnail size
= 0.1.7 =
* Better documentation
= 0.1.6 =
* **[content]** - Added menu and sidebar content
* **[loop]** - Pass a field content as parameter to another shortcode
= 0.1.5 =
* Added simple gallery fields
* Added attachment type and fields
= 0.1.4 =
* Added **[loop]** shortcode for query loops
* Format post content using the_content filter
= 0.1.3 =
* Changed shortcode to **[content]**
* Added banner image to Wordpress plugin page
= 0.1.2 =
* Better documentation
= 0.1.1 =
* Simplified code, added a few parameters
= 0.1 =
* First release
== Upgrade Notice ==