=== Category Pages & Posts Shortcodes ===

Contributors: swergroup, pixline

Donate link: https://bitly.com/Vpy3MP

Tags: category, categories, pages, posts, page, post, integration, shortcode, shortcodes, list, archives

Requires at least: 3.4.2

Tested up to: 3.4.2

Stable tag: trunk

License: GPLv2

License URI: http://www.gnu.org/licenses/gpl-2.0.html

Useful shortcodes to display a post or page content or a list of posts.

== Description ==

Category Pages & Posts Shortcodes is a complete rewrite of the "Category Page" plugin.

It offers useful shortcodes to display a post or page content, or a list of posts.

Also it allow exclusive mutual bind between a Category and a Page, in order to display the page content as "header" of category archives. 

You can safely use shortcodes inside a post or a page, our you can embed them in your theme 

using the [do_shortcode](http://codex.wordpress.org/Function_Reference/do_shortcode) WordPress function like that:

`<?php do_shortcode('[showsingle pageid="<id_of_page>"]'); ?>`

NOTE: This plugin requires WordPress 3.4.x, and will **break** your current ~2.5 setup.

It also won't be compatible with [Category Page Extender](http://categorypageextender.wordpress.com) anymore. 

On activation, it will clean every option set by the previous versions. Please test it offline first.

= [showsingle pageid="" postid="" showheader="" header="" headerclass="" wrapper="" wrapperclass=""] =

This shortcode will show a single post or page. The only required argument is either *postid* or *pageid*.

* **pageid** - ID of the page you want to display (either this or postid)

* **postid** - ID of the post you want to display (either this or pageid)

* **showheader** - if *"true"*, show the page title

* **header** - level of title HTML header (from 1 to 6, 2 default)

* **headerclass** - header custom CSS class (default: `aptools-single-header`)

* **wrapper** - if *"true"*, wraps the whole output with `<div class="aptools-wrapper"></div>`

* **wrapperclass** - wrapper custom CSS class (default: `aptools-wrapper`)

= [showlist catid="" lenght="" listclass="" excerpt="" wrapper="" wrapperclass=""] =

This shortcode will show a list of posts from you. Required argument is catid.

* **catid** - ID (**not** slug, nor name) of the category you want to list

* **lenght** - how many posts listed (default: 10. don't set it too high..)

* **listclass** - list element's custom CSS class (default: `aptools-list`) 

* **excerpt** - if *true* shows excerpt alongside title

* **wrapper** - if *"true"*, wraps the whole output with `<div class="aptools-wrapper"></div>`

* **wrapperclass** - wrapper custom CSS class (default: `aptools-wrapper`)

= [showauto] =

This shortcode works only on category archives templates: it will display on each category the linked page content.

You can set up the link either on the page edit admin area or in the category edit area. 

Please note: a single page can be linked this way to a single category only. 

If you need more flexible options you should take advantage of [WordPress template hierarchy](http://codex.wordpress.org/Template_Hierarchy): 

you can create a `category-<category_name>.php` file with a `[showsingle]` shortcode. 

GPL2(C) 2008+ [SWER Siti internet Torino](http://swergroup.com/)

[Git source code on Bitbucket](http://dev.swergroup.com/pages-and-posts-shortcodes)

[Support Forum on wordpress.org](http://wordpress.org/support/plugin/page2cat)

== Installation ==

1. Download the plugin, unzip, upload folder to your `/wp-content/plugins/` directory

1. Activate the plugin through the 'Plugins' menu in WordPress

1. Look for the documentation on the plugin page and learn how to use it.

1. Enjoy!

== Frequently Asked Questions ==

= Is this plugin supported? =

We'll try our best to support it on the [support forum](http://wordpress.org/support/plugin/page2cat).

If you rely on this plugin for commercial purposes please get in touch with our [helpdesk](http://swergroup.zendesk.com).

= I used to see [page|menu|box] Category Page, where is it? =

It probably isn't here. WordPress changed a lot since 2007. 

You should be able to solve with shortcodes quite everything you were used to. If you can't manage it drop us a line in the support forum and we'll try to find a solution.

= Why you didn't update Category Page and rewrote it instead? =

The original concept and codebase were obsolete, with a lot of logic flaws. We just couldn't avoid it.

= Where is the last pre 3.0 version? =

Last pre-3.0 version is 2.6.3, [SVN r367559](http://plugins.trac.wordpress.org/browser/page2cat?rev=367559)

You can download it by SVN client: 

`svn -r 367559 checkout http://plugins.svn.wordpress.org/page2cat/trunk/ page2cat-2.6.3`

== Screenshots ==

1. Sample page inclusion as an archive page header via [showsingle]

== Changelog ==

= 3.0.6 =

* (11/11/2012) FIX Warning on admin Page area. 

* (11/11/2012) FIX Better headers and descriptions

* (11/11/2012) FIX [showauto] formatting and styles

= 3.0.5 =

* (11/11/2012) Fix error on the admin Page area. 

= 3.0.3 =

* (10/11/2012) Better descriptions in edit-page and edit-category forms

* (10/11/2012) Fix links

= 3.0.2 =

* (04/11/2012) showlist query fix.

= 3.0.1 =

* (03/11/2012) *[showlist]* shortcode fix, category › page link restored.

= 3.0 =

* (30/10/2012) Complete rewrite for WordPress 3.4+

== Upgrade Notice ==

= 3.0.6 =

* (11/11/2012) FIX warning on admin page area, [showauto] formatting, headers and descriptions.

= 3.0.5 =

* (11/11/2012) Fix error on the admin Page area. 

= 3.0.3 =

CAUTION: This plugin requires WordPress 3.4.x, and will **break** your WP 2.5 setup.

- Better descriptions in edit-page and edit-category forms

- Fix links

= 3.0.2 = 

CAUTION: This plugin requires WordPress 3.4.x, and will **break** your WP 2.5 setup.

FIX showlist category query.

= 3.0 =

This plugin requires WordPress 3.4.x, and will **break** your WP 2.5 setup.

It also won't be compatible with [Category Page Extender](http://categorypageextender.wordpress.com) anymore. 

On activation, it will clean every option set by the previous versions. Please test it offline first.