WordPress.org

Plugin Directory

Changeset 481371


Ignore:
Timestamp:
12/28/11 04:46:47 (2 years ago)
Author:
jakemgold
Message:

Version 3.0 is basically a complete rewrite!

  • Unlimited secondary HTML content blocks (well, up to 100)
  • Name secondary blocks anything!
  • Full support for visual / HTML modes in the editor
  • Full support for custom post types
  • Per block settings for media buttons
  • New per block option to use a more basic editor
  • Filters for developers
Location:
secondary-html-content/trunk
Files:
1 added
2 deleted
4 edited

Legend:

Unmodified
Added
Removed
  • secondary-html-content/trunk/readme.txt

    r364793 r481371  
    11=== Secondary HTML Content === 
    2 Contributors: jakemgold, thinkoomph 
     2Contributors: jakemgold, 10up 
    33Donate link: http://www.get10up.com/plugins/secondary-html-content-wordpress/ 
    44Tags: HTML, editor, WYSIWYG, tinymce, widget, sidebar, content 
    5 Requires at least: 2.8 
    6 Tested up to: 2.9.2 
    7 Stable tag: 2.0 
     5Requires at least: 3.3 
     6Tested up to: 3.3 
     7Stable tag: 3.0 
    88 
    9 Add a up to 5 blocks of HTML content to pages and posts. Perfect for layouts with distinct content blocks, such as a sidebar or two column view. 
     9Add additional HTML blocks to any post type. Perfect for layouts with distinct content blocks, such as a sidebar or two column view. 
     10 
    1011 
    1112== Description == 
    1213 
    13 Add up to 5 blocks of HTML content to WordPress pages andposts. A perfect solution for layouts with distinct content "blocks", such as a sidebar or multi-column view. When editing content, the secondary WYSIWYG content editors will appear beneath the standard content editor. 
     14Add unlimited extra HTML content blocks to pages, posts, and custom post types. A perfect solution for layouts with distinct content "blocks", such as a sidebar or multi-column view. When editing content, the secondary editors appear beneath the usual editor. 
    1415 
    15 You can choose to add up to 5 new HTML blocks to pages and posts independently. For example, you could have no extra post blocks, and 3 extra page blocks. With pages, you can optionally inherit secondary HTML content from the page's ancestry (parents, grandparents, etc). Perfect for 
    16 section-wide sidebars. 
     16Name the new content blocks anything, and assign each block to any of your site's public post types. Hierarchical post types, like pages, can optionally inherit their content from ancestors (including their parent page); perfect for section wide sidebars. Each block can individually be customized to offer media buttons and the full or more stripped down version of the editor. 
    1717 
    18 Secondary content can be used by added to the theme by using the new widget ("Secondary HTML Content"), or by calling the content via a function in your template. See "Installation" for guidance on using the function. 
     18Secondary content can be added to your site by using the Secondary HTML Content widget. Theme developers can also call secondary blocks by using the built in functions (see "Installation"). 
    1919 
     20REQUIRES WordPress 3.3 or newer. 
    2021 
    2122 
    2223== Installation == 
    2324 
    24 1. Install easily with the WordPress plugin control panel or manually download the plugin and upload the extracted folder to the `/wp-content/plugins/` directory 
    25 1. Activate the plugin through the Plugins menu in WordPress 
    26 1. Configure with the new "Secondary HTML" menu option under "Settings"  
    27 1. Start entering secondary content! Output using the widget by going to the widget menu under apperance, or use the `get_secondary_content()` and `the_secondary_content()` functions in your template! 
     251. Install easily with the WordPress plugin control panel or manually download the plugin and upload the extracted folder to the `/wp-content/plugins/` directory. 
     261. Activate the plugin through the Plugins menu in WordPress. 
     271. Define new secondary HTML blocks using the new Secondary HTML Content section on the Writing settings page. 
     281. Start entering secondary content by editing your content! 
     291. Output secondary blocks by using the Secondary HTML Content widget (Appearance > Widgets) or by using the `get_secondary_content()` and `the_secondary_content()` functions in your template! 
    2830 
    29 = The Functions = 
     31= Theme Code Example = 
    3032 
    31 Both functions take 2 optional parameters: block number, and post ID. If no block number is specified, it will default to the first secondary content block (value of 1). If no post ID is provided, it will default to the current post. Consistent with standard WordPress conventions, `get_secondary_content()` will return the value for the content block, while `the_secondary_content()` will echo it. 
     33`the_secondary_content( 'More Info', 20 );` 
    3234 
    33 Example: `the_secondary_content();` 
     35Prints out content from the secondary block named "More Info" assigned to page ID 20. 
    3436 
    35 Outputs the current pages first additional content block. 
     37`the_secondary_content( 'Contact Information' );` 
    3638 
    37 Example: `the_secondary_content(2,22);` 
     39Prints out content from the secondary block named "Contact Information" for the current post. 
    3840 
    39 That will output the the second additional content block for page/post ID 22. 
     41`the_secondary_content();` 
     42 
     43Prints out content from the first secondary block assigned to the current post type, for the current post. Useful in situations where there is only one secondary content block. 
    4044 
    4145 
    4246== Screenshots == 
    4347 
    44 1. Screenshot of the page editor with new, secondary HTML block. 
    45 2. New widget: add secondary HTML to sidebar. 
    46 3. Configuration panel. 
     481. Editing a page with a secondary content block named "Specifications". 
     492. Managing secondary content blocks. 
     503. Add secondary HTML content to the site using a widget. 
    4751 
    4852 
    4953== Changelog == 
     54 
     55= 3.0 = 
     56* Effectively a complete rewrite! 
     57* Unlimited secondary HTML content blocks (well, up to 100) 
     58* Name secondary blocks anything! 
     59* Full support for visual / HTML modes in the editor 
     60* Full support for custom post types 
     61* Per block settings for media buttons 
     62* New per block option to use a more basic editor 
     63* Filters for developers 
    5064 
    5165= 2.0 = 
     
    6074* Many under the hood changes and enhancements 
    6175 
     76 
    6277== Upgrade Notice == 
    6378 
    64 = 2.0 = 
    65 The pre-2.0 function calls are backwards compatible, and the plugin will upgrade your custom fields. If you are using the widget, you may, however, need to re-add the widget due to fundamental changes to the widget's configuration and setup. 
     79= 3.0 = 
     80Virtually a complete rewrite, 3.0 *REQUIRES* WordPress 3.3 or newer. The plug-in will stop working on older versions (you can manually downgrade). A seamless upgrade path from v2.0 of the plug-in is built it. Note that plug-in settings have been *moved to Settings > Writing*. 
Note: See TracChangeset for help on using the changeset viewer.