=== Plugin Name ===
Contributors: applh
Donate link: http://applh.com/
Tags: widget, post, sidebar, content, mix, multi loop, shortcode, page, theme, builder, custom, layout, markdown, csv, speadsheet, google, docs, webhook
Requires at least: 3.5
Tested up to: 3.8
Stable tag: trunk
License: GPLv3
License URI: http://www.gnu.org/licenses/gpl-3.0.html
Mix website contents with WParty
* pages
* articles
* widgets
* menus
* contact form...
* Simple Shortcode [part]
* DEV: Theme Builder
== Description ==
WParty is a WordPress Plugin to mix your website contents
* Pages
* Articles
* Widgets
* Contact Form
* Menus
* Media
* DEV: Theme Builder
= PAGES =
* Do you want to include the content from another page ?
* Simply use the shortcode [part]
* [part name="page-name"]
* Custom HTML styles attributes can be added (id, class, style).
* [part name="page-name" id="my-id" class="my-class" style="background-color:#123456;"]
= Note =
* The plugin also activates ALL shortcodes in Text Widgets.
* It makes easier to write HTML content in WordPress Editor, using Pages Rich Editor, and then embed the content in Text Widgets.
= Note =
* The plugin also disables WordPress auto (P)(/P).
* The shortcode [part name="page-name"] can access to all public and private pages/articles (warning to multi-users site)
* This choice allows to keep parts as private content
= REDIRECT =
* Simple page redirection
* [part widget="redirect" instance="/page-new-url/"]
= SHORTCODE PROGRAMMING =
* Manage easily Events or Multi-languages websites...
* Conditions can be combined with widgets.
= DATE CONDITIONS =
* display shortcode content between 01/03/2013 and 25/03/2013 ?
* [part name="page-name" start="01-03-2013" end="25-03-2013"]
= REQUEST CONDITIONS =
* display shortcode content if URL has GET specific parameter...
* http://mysite.com/my-page/?lang=fr
* [part if="lang=fr" widget="redirect" instance="/page-lang-fr/"]
= LIST WIDGET: CUSTOM LOOP AND HTML LAYOUT =
* The widget "list" accepts a custom HTML model
`
[part widget="list" args="numberposts=5&tag=my-tag1,my-tag2"]
CONTENT
TAGS / CATS / DATE
[/part]
`
= META =
* Do you want to display post meta inside the post content ?
* [part meta="meta-name"]
= LOOP =
* Default LOOP can be included same as a widget:
* Read more... http://codex.wordpress.org/Template_Tags/get_posts
* [part widget="loop"]
* [part widget="loop" args="numberposts=5&tag=my-tag1,my-tag2"]
= CONTACT FORM =
* Do you want to add a contact form ?
* [part widget="contact"]
* Or build your custom contact form
* Translate your contact form as needed
`
[part widget="contact"]
[/part]
`
= Note =
* Content can embed recursive shortcodes (max=10).
= WORDPRESS WIDGETS =
* WP Widgets can be added inside Pages/Posts. (Calendar, Recent_Posts, Tags, RSS, etc...).
* Read more... http://codex.wordpress.org/Function_Reference/the_widget
* [part widget="news"]
* [part widget="tags"]
* [part widget="categories"]
* [part widget="archives"]
* [part widget="calendar"]
* [part widget="pages"]
* [part widget="rss" instance="url=http://applh.com/feed/"]
* [part widget="menu" instance="nav_menu=my-menu"]
= SIDEBARS =
* [part widget="sidebar" name="theme-sidebar-name"]
= LOREM IPSUM =
* Fill with text "Lorem Ipsum..."
* [part widget="lorem"]
* [part widget="lorem" max="200"]
= PDF =
* Embed a PDF viewer in your website
* See... https://docs.google.com/viewer
* [part widget="pdf" width="640" height="640"]http://your.website.com/file.pdf[/part]
= MAP =
* Embed a Google Map in your website
* See... https://maps.google.com/
* [part widget="map" width="640" height="640"]http://maps.google.fr/maps?q=paris[/part]
* (note: don't use the short URL http://goo.gl/maps/...)
= MARKDOWN =
* Prefer writing with MarkDown Syntax ?
* See... http://daringfireball.net/projects/markdown/syntax
* Requirements: PHP5.3+
`
[part widget="mark"]
# This is an H1
## This is an H2
###### This is an H6
1. Bird
2. McHale
3. Parish
* Red
* Green
* Blue
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
[/part]
`
= CSV =
* Need to include some CSV data as a Table?
* Requirements: PHP5.3+
* note: empty lines are ignored
`
[part widget="csv"]
cell11,cell12,cell13
cell21,cell22,cell23
cell31,cell32,cell33
[/part]
[part widget="csv" cut="|"]
cell11|cell12|cell13
cell21|cell22|cell23
cell31|cell32|cell33
[/part]
`
= WEBHOOKS: MARK2 and CSV2 =
* Need to fetch data from an URL ?
* eg: Google SpreadSheet
* Include some CSV external data as a Table
* Include some Markdown external code
* Requirements: PHP5.3+
`
[part widget="mark2"]
https://docs.google.com/spreadsheet/pub?key=0AhDBS7EaaokRdGQ5Z1g5cjE1YzRUS3NxRmZ4RGJYRGc&output=txt
[/part]
[part widget="csv2"]
https://docs.google.com/spreadsheet/pub?key=0AhDBS7EaaokRdGFFRGNjam1HOEk2dU84d19IUGZlWVE&single=true&gid=0&output=csv
[/part]
`
= PAGE TEMPLATE =
* Need to customize your active theme with a new Page Template ?
* [part dev="add-template" file="my-template" text="Template Name"]
* creates a file my-template.php with needed code to show as a Page Template
* (note: edit-theme role capability is required)
= THEME BUILDER =
* Need to create a new Theme ?
* WParty is also a theme builder
* [part theme="My Theme" name="new-theme"]
* creates the folder /themes/new-theme/ and WP theme files inside to show as "My Theme" in Appearance Menu
* (note: edit-theme role capability is required)
= Note =
* WParty is designed to work with MultiSites installation.
= MEDIA =
* UNDER DEVELOPMENT
* Creates a local cache copy of original image
* Cache folder is /uploads/wparty/
* [part widget="media"]http://somesite.com/image.jpg[/part]
* [part widget="media" width="100"]http://somesite.com/image.png[/part]
* [part widget="media" width="100" height="200"]http://somesite.com/image.gif[/part]
= SLIDER =
* UNDER DEVELOPMENT
* [part widget="slider" name="my-slider"]
== Installation ==
This section describes how to install the plugin and get it working.
e.g.
1. Upload `/wparty/` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Add shortcode `[part name="page-name"]` in your pages content
== Frequently Asked Questions ==
= What is a PART ? =
* PAges, ARTicles...
* This plugin allows to mix contents with ShortCode.
* ...PART ;-p
= Can we program with ShortCodes ? =
WParty add a shortcode to expose some WP API.
Webmasters can create some simple 'program' with shortcodes.
'Pages' can be seen as 'functions'.
== Screenshots ==
1. This screen shot description corresponds to screenshot-1.(png|jpg|jpeg|gif). Note that the screenshot is taken from
the /assets directory or the directory that contains the stable readme.txt (tags or trunk). Screenshots in the /assets
directory take precedence. For example, `/assets/screenshot-1.png` would win over `/tags/4.3/screenshot-1.png`
(or jpg, jpeg, gif).
2. This is the second screen shot
== Changelog ==
= 1.7.9 =
* new webhook widgets "csv2" "mark2": [part widget="csv2"]http://url-to-text-data[/part]
= 1.7.x =
* new widget "csv": [part widget="csv"]col1,col2,col3[/part]
* new widget "mark": [part widget="mark"]markdown syntax[/part]
* new widgets "pdf", "map"
* shortcode to add page template to active theme
* widget lorem
* widget media [DEV]
* widget contact more customizable
* code separated in several files
= 1.6.x =
* add contact form widget
* Add custom layout
* DISABLE WordPress autop
* more customisation on theme builder
* more recursion in widget LIST
* Add widget 'list'
* Add protection against infinite loop (recursion max=10)
* Add CONDITIONS to parts (if, start, end)
Manage easily Events or Multilang
* Add Redirection widget
* Add Meta part
= 1.5.x =
* BUGFIX: Add missing filter
* Add Widgets LOOP, SIDEBARS
= 1.4 =
* Add Widgets
= 1.3 =
* Bug Correction
* Add Widgets
* DEV: Add theme builder
= 1.2 =
* Add custom CSS (id, class and style)
* Add custom menu inclusion
= 1.1 =
* Add recursion in page content for embedded shortcodes
* Activate shortcodes in Text Widget
= 1.0 =
* Initial version
== Upgrade Notice ==
= 1.7.9 =
* new webhook widgets "csv2" "mark2": [part widget="csv2"]http://url-to-text-data[/part]
= 1.7.8 =
* new widget "csv": [part widget="csv"]col1,col2,col3[/part]
= 1.7.7 =
* new widget "mark": [part widget="mark"]markdown syntax[/part]
= 1.7.6 =
* new widgets "pdf", "map"
= 1.7.5 =
* shortcode to add page template to active theme
= 1.7.4 =
* widget lorem
* widget media [DEV]
= 1.7 =
* widget contact more customizable
* code separated in several files
= 1.6.3 =
* add contact form widget
* Add custom layout
= 1.6.2 =
* DISABLE WordPress autop
* more customisation on theme builder
* more recursion in widget LIST
= 1.6.1 =
* Add widget 'list' for custom loop layout
* Add protection against infinite loop (recursion max=10)
= 1.6 =
* Manage easily Events or Multilang
* Add CONDITIONS to parts (if, start, end)
* Add Redirection widget
* Add Meta part
= 1.5.1 =
BUGFIX
= 1.5 =
More features.
= 1.4 =
More features.
= 1.3 =
More features. Bugs Correction.
= 1.2 =
More features
= 1.1 =
The plugin activates shortcodes in Text Widget.
Easier writing of HTML with WP Editor!
Simply include [part page="page-name"] to get your HTML content in text widget.
= 1.0 =
Improve content management for your website.
== Happy New Year ==
Best wishes for 2013. ;-)