=== Organized Docs === Contributors: isabel104 Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=me%40isabelcastillo%2ecom Tags: documentation, docs, organize documentation, organized documentation, instruction guides, wiki Requires at least: 3.9 Tested up to: 3.9.1 Stable Tag: 2.0 License: GNU Version 2 License URI: http://www.gnu.org/licenses/gpl-2.0.html Easily create organized documentation for multiple products, organized by product and by subsections within each product. == Description == Create documentation for multiple items, for example, for multiple software products. This is for you if you need to create documentation for multiple products, and must have the docs organized neatly, by product. The main "Docs Page" will list all the products. Clicking on a product will take you to the docs only for that product. Each product's docs is further organized into subsections. The subsections list each individual article in that docs section. The single docs posts will have a Docs Table of Contents widget added to the sidebar. This will show a Table of Contents for docs pertaining only to the product which this current single doc belongs to. Demo [Organized Docs on Twenty Fourteen](http://smartestthemes.com/organized-docs-wordpress-plugin/docs/) theme Demo [Organized Docs on Twenty Twelve](http://smartestthemes.com/organized-docs-on-twentytwelve/docs/) theme [Setup Instructions](http://isabelcastillo.com/docs/how-to-set-up-categories) [Documentation](http://isabelcastillo.com/docs/category/organized-docs-wordpress-plugin) For support or to report bugs, use the support forum link above, or use [GitHub](https://github.com/isabelc/Organized-Docs). Forking welcome. == Installation == 1. Download the plugin file (`.zip`). 2. In your WordPress dashboard, go to "Plugins -> Add New", and click "Upload". 3. Upload the plugin file and activate it. 4. See [How To Set Up Categories For Docs](http://isabelcastillo.com/docs/how-to-set-up-categories) == Frequently Asked Questions == = Why does the Table of Contents widget appear multiple times on the same page? = This is no longer an issue since version 2.0. == Screenshots == 1. Back-end Admin screen – Organized Docs WordPress Plugin 2. All Docs For 1 Product 3. Single docs post with Table of Contents == Changelog == = 2.0 = * NOTE: This update has many changes, including style changes, so, please read this entire changelog section. * New: new template files eliminate the need to hijack sidebars. Easily make your custom docs templates by adding a folder named organized-docs to your theme. In that folder, you can add a custom single.php, taxonomy.php, archive.php, and sidebar.php. See our new templates directory to copy the originals. * New: option to set custom sort order for single docs. You can sort alphabetically, by date, or by custom sort order number. You can also choose to sort in ascending or descending order. * New: option to NOT list each single docs post on the top-level item page, nor in the Table of Contents sidebar. Enable this option if you want to list only the subheadings. * New: option to change the main Docs slug. For example, you could change it to books. * New: option to change the page title on the main Docs page. * New: option to not load Font Awesome stylesheet if your theme, or other plugin, already loads it. Checking this will increase your page load speed. If left unchecked, it will only load Font Awesome on single Docs, in the footer, and only if you use the printer icon. * New: Docs now include schema.org microdata for TechArticle on single Docs, and microdata for CollectionPage on Docs archives pages. There is an option to disable microdata. * New: If you are NOT using Twenty Fourteen theme, and you did insert a call to twentyfourteen_post_nav() in order use single Docs navigation, please note that it is no longer necessary since we have a new template system. So, you can remove your call to twentyfourteen_post_nav(). * Fix: a subheading without a sort order number would not display in some instances. * Fix: no longer overriding the _post_nav for the default WP themes. * Deprecated: od_docs_main_title filter is deprecated and no longer needed since an option to change the main Docs title is now added. Also, this filter while in legacy-use returns only text, not HTML h1 element. If you are hooking this filter, please update it to return just the text, or remove it altogether in favor of the new option. * Tweak: changed h2 page title element on Docs archive pages to h1. You may need to adjust size. * Tweak: load styles in footer for increased page load speed. And load it only on Docs pages. * Tweak: updated styles for Twenty Fourteen, Twenty Thirteen, and Twenty Twelve themes. * Tweak: use singleton class. * Tweak: no longer hiding the single docs title. * Tweak: no longer necessary to manually drag the Table of Contents widget over to the Docs Widget Area. * Tweak: Table of Contents widget will not give error if not on single docs page anymore. This makes it safe to add this widget anywhere, for example, when using your own custom templates with your own sidebar areas. * Tweak: updated .pot language file. = 1.2.2 = * Fix: 2 files were not synced to svn: custom.php and the localization file. * New: option to use title anchor text on Docs post nav links, instead of 'next' and 'previous'. * New: option to disable comments on Docs. * Maintenance: updated .pot file. = 1.2.0 = * New: option to hide custom sidebar IDs to avoid multiple Table of Contents widgets. * New: option to hide printer icon and print link. * New: Navigate through next and previous docs. If you are not using Twenty Fourteen theme, call twentyfourteen_post_nav() in your single.php to use this feature. * Tweak: better styling and padding for compatibility with Twenty Fourteen theme. * Maintenance: updated .pot file. = 1.1.10 = * New: added .pot file for localization. * Maintenance: reset option to update all docs posts with default sort order. * Maintenance: removed warning from array_combine when docs category terms are missing. = 1.1.9 = * New: option to delete all Docs data upon uninstall. * Fix: 1 line which caused posts to save order number as 99999 and ignore the custom number. = 1.1.8 = * Fix: Typo in function name stopped script from assigning default sort-order to existing posts. = 1.1.7 = * Fix: Docs would not display if custom sort-order was not set. Now, it is not necessary to set a custom sort oder. It remains optional. * Maintenance: removed script to give subheadings a default order since no longer needed. = 1.1.6.1 = Bug fix: Custom sort-order for Categories was not saving. = 1.1.6 = * Fix: give default order to sub-headings. PLEASE UPDATE NOW. = 1.1.5 = * New: added sort order for Top-level Doc Items, and for Sub-headings, and for individual Doc articles. * New: uninstall.php to remove docs, taxonomies, and custom term options upon uninstall. * Fix: PHP error notices on admin Parent column if no category was assigned. * Tweak: removed generator tag for less markup. * Tweak: added links to 2 demos in the description. * Maintenance: updated plugin URL in readme. * Maintenance: tested and passed for WP 3.9 compatibility. * Maintenance: Removed CSS styling for docs-template for better compatibility with Twenty Fourteen Theme. See http://isabelcastillo.com/docs/page-is-too-wide-and-not-centered-since-updating-to-1-1-5 = 1.1.4 = * Maintenance: removed unused icons. = 1.1.3 = * Bug fix: Table of Contents Widget was showing up 3 times on Twenty Fourteen theme. * New: added Print button to single docs. * New: added link to Setup Instructions. * Maintenance: added support for Twenty Fourteen Theme. * Maintenance: updated the icon for Docs. * Maintenance: removed PHP notices and errors. = 1.1.2 = * Bug fix: Main Docs page query was broken. * Tested for WP 3.8 compatibility. = 1.1 = * Bug fix: slug for docs category taxonomy was broken. * Tested for WP 3.7.1 compatibility. = 1.0 = * Initial release. == Upgrade Notice == = 2.0 = NOTE: This update has many changes, including style changes, so, please read changelog. = 1.2.2 = Fix: custom.php file was not synced to svn. = 1.2.0 = New: option to hide custom sidebar IDs to avoid multiple Table of Contents widgets. = 1.1.9 = Fix 1 line which caused posts to save order number as 99999 and ignore the custom number. = 1.1.8 = Fix: Typo in function name stopped script from assigning default sort-order to existing posts. = 1.1.7 = Fix: Docs would not display if sort-order was not set. Now, it is not necessary to set custom sort oder. = 1.1.6.1 = Bug fix: Custom sort-order for Categories was not saving. = 1.1.6 = Fix: Give default order to sub-headings. New: set custom sort order. = 1.1.5 = New: set custom sort order for Top-level Doc Items, Sub-headings, and individual articles. = 1.1.4 = Bug fix: Table of Contents Widget was showing up 3 times on Twenty Fourteen theme.