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-.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. +