diff -r 2f6f6f7551ca -r 32102edaa81b web/wp-content/plugins/page2cat/readme.txt --- a/web/wp-content/plugins/page2cat/readme.txt Thu Sep 16 15:45:36 2010 +0000 +++ b/web/wp-content/plugins/page2cat/readme.txt Mon Nov 19 18:26:13 2012 +0100 @@ -1,47 +1,146 @@ -=== Category Page === -Contributors: pixline -Donate link: http://tinyurl.com/375yrk -Tags: admin, pages, category, formatting, plugin, categories, integration, page, theme -Requires at least: 2.2 -Tested up to: 2.5 -Stable tag: 2.5 - -Use pages as category archive header, or list some posts from a category into a post/page. - -== Description == - -This plugin will let you setup connection between pages and categories, in order to display the page content like a "header" for your category archive (theme tweak required). By popular demand, version 2.5 also ships with a shortcode like [catlist] that allows to display a list of posts from a certain category inside a post or a page. -. -Copyright (C) 2008 Paolo Tresso / [Pixline](http://pixline.net/) - -[plugin page](http://pixline.net/wordpress-plugins/category-page-plugin/en/) - [support forum](http://talks.pixline.net/forum/category-page-plugin) - -== Installation == - -1. Download the plugin Zip archive. -1. Upload `Category Page` folder to your `/wp-content/plugins/` directory -1. Activate the plugin through the 'Plugins' menu in WordPress -1. Setup some relationship between Categories and Pages -1. Tweak `archive.php` in your theme folder (while I write documentation, please [read here](http://talks.pixline.net/topic.php?id=13#post-32) to learn how). -1. Enjoy! - -[plugin page](http://pixline.net/wordpress-plugins/category-page-plugin/en/) - [support forum](http://talks.pixline.net/forum/category-page-plugin) - - -== Changelog == - -* 2.5 (26/03/07) WordPress 2.5 compliance. Theme examples released as separate theme pack. -* 0.4.4 (03/09/07) fix content filters. 2.3 compliant release. -* 0.4.3 (30/08/07) 2.3beta1-compliant release -* 0.4.2 (22/08/07) microbugfix, example files for Kubrik, Hemingway and Sandbox themes. -* 0.4.1 (15/08/07) fix 'foreach' errors -* 0.4 (10/08/07) stable release for 0.4. going to the next level. -* 0.4b2 (06/08/07) fix for db version... -* 0.4b (05/08/07) TESTING RELEASE svn only. moved to database, plugin almost rewritten from scratch. -* 0.3 (27/07/07) many fixes for 2.1.3, 2.2.1 and svn compatibility. archive.php example fixed. -* 0.2.1 (19/07/07) fixed backward compatibility for 2.1 -* 0.2 (18/07/07) management and options panel, better sidebox, widget available, one more example theme. -* 0.1 (17/07/07) first tag. alpha 2 with some typo fixing. -* 0.1a2 (17/07/07) fix sidebox in page editing, manage panel. -* 0.1a (16/07/07) first public alpha. -` \ No newline at end of file +=== 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: + +`"]'); ?>` + +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 `
` +* **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 `` +* **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-