=== Organized Docs === Contributors: isabel104 Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=me%40isabelcastillo%2ecom Tags: documentation, docs, organized documentation, instruction guides, easy docs Requires at least: 4.0 Tested up to: 4.3 Stable tag: 2.2 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 any number of products, organized by product, and by sub-headings within each product. You can use this to create instruction guides for just about anything. This is for you if any of these apply: * You need to create software documentation. * You need to create documentation for one or multiple products, and must have the docs organized neatly, by product. * You need to write instruction guides for virtually anything, whether it be products, games, topics, etc. You can label them as "Instructions" instead of "Docs". * You don't want to create a separate website for your docs. You simply want to add them on to your current WordPress site. **Built-in SEO** Documentation articles will have schema.org microdata. It adds **TechArticle** microdata to single Docs, and **CollectionPage** microdata to Docs archives. You can disable the microdata. **Documentation With a User-Friendly Structure For Your Visitors** 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 are organized into subsections. The subsections list each individual article in that docs section. A single docs post will have a 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. Organized Docs works on **Multisite** WordPress installations, as well as regular WordPress sites. See a live demo of [Organized Docs on a default WordPress theme](http://smartestthemes.com/organized-docs-wordpress-plugin/docs/) [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) 5. Create your Docs articles. Visit your website at `www.your-webiste.com/docs/` to see your Docs. == Frequently Asked Questions == = Why is the layout all messed up? = The Organized Docs layout is compatible with these default WordPress themes: Twenty Fifteen, Twenty Fourteen, Twenty Thirteen, and Twenty Twelve. On other themes, the layout may look all messed up. It’s very easy to fix this by copying the template files into your theme. Once you have copied them, make the necessary changes to the HTML to make it match your own theme, while leaving the important Organized Docs loop stuff intact. See how to [Customize The Docs Template Files](http://isabelcastillo.com/docs/customize-the-docs-template-files). = Where do I see the Docs on the front end? = Visit your website at `www.your-webiste.com/docs/` to see your Docs. Alternatively, add individual Doc products (categories) to your Menu in your dashboard --> Appearance --> Menus. This last method is better for you if you are only documenting one product on the site (rather than multiple products). = 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. Main Docs page on 2015 theme showing all main, top-level items 2. All Docs for 1 product on 2015 theme 3. All Docs for 1 product on 2014 theme 4. All Docs for 1 product on 2013 theme 5. A single Docs article with Table of Contents on 2015 theme 6. A single Docs article with Table of Contents on 2014 theme 7. A single Docs article with Table of Contents on 2013 theme 8. Back-end Docs Admin screen == Changelog == = 2.2 = * Fix - The taxonomy page for a sub-category was only showing a max of 10 posts. Now it shows all posts for that sub-category. * Tweak - Updated structured data microdata properties. = 2.1.1 = * New - Option to show last updated date on single Docs articles. * Tweak - Better handling of the Disable Comments on Docs option. * Tweak - Updated the version in template files. = 2.1 = * New - All 4 template files have been updated. If you are using a custom template file for Docs in your theme, you must update the file for Docs to work properly. Please see the documentation, under What's New, for an easy link to grab the new template files. * New - Option to sort main, top-level Doc items by alphanumerical order. * New - The CSS has been rewritten to leave a more neutral style for the Docs nav menu and the Table of Contents widget. The entire layout has been made compatible with Twenty Fifteen theme, as well as remaining compatible with Twenty Fourteen, Twenty Thirteen, and Twenty Twelve. Please see the documentation, under What's New, for a list of all CSS changes. * Optimization - The toggle option now uses pure JavaScript. There is no jQuery dependency. * Optimization - Use an HTML entity for the print icon instead of Font Awesome. There is no more option to include Font Awesome. * Fix - dynamic_css() was adding empty style tag to head in some cases. * Tweak - Renamed the function sort_terms to sort_terms_custom. * Tweak - Updated .pot translation file. = 2.0.4 = * New - option to toggle the list of individual Docs articles on the top-level category pages. * New - option to toggle the list of individual Docs articles in the Table of Contents widget. * Fix - remove several PHP warnings that occurred when viewing a single Doc while a category was not assigned to the Doc. * Tweak - updated the URL for Setup Instructions. * Maintenance - updated the Table of Contents widget to work with the WordPress 4.0 customizer. * Maintenance - updated .pot translation file. = 2.0.3 = * Tweak: moved prev/next nav links for single docs to a template tag for easier-to-customize template files. * Tweak: put back missing comments into single template. * Tweak: taller line-height on main docs page. * Tweak: eliminated a PHP notice that was triggered in organized_docs_content_nav when sub-categories were not assigned. * Tweak: eliminated 2 PHP notices that were triggered in organized_docs_post_nav. * Tweak: updated `.pot` translation file. = 2.0.2 = * Fix: improved styling for mobile devices. * New: option to disable the Docs Menu Link that get automatically added to your site. You can still add your own link in Appearance: Menus. * Tweak: changed category label from just Category to Docs Category for better usability. * Tweak: minified CSS for faster page load speed. = 2.0.1 = * NOTE: Please see changes for version 2.0. * Fix: filter the content on single docs. = 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.1 = All 4 template files have been updated. If you update, you must also update your custom template files! = 2.0.4 = Removed several PHP warnings that occurred when viewing a single Doc while a category was not assigned to the Doc. = 2.0.1 = Fix: filter the content on single docs. NOTE Please see changes for version 2.0. = 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.