=== Dexs Navigation Tree ===
Contributors: sambrishes
Donate link: http://www.gofundme.com/81q7rg
Tags: table, of, contents, navigation, tree, widget, table of contents, content, index, links, navi, sitemap, site, map, toc, sidebar
Requires at least: 3.6
Tested up to: 4.0
Stable tag: 1.2.0
License: MIT License
License URI: http://opensource.org/licenses/MIT
A "Table of Content" container with a few settings, useable with a shortcode or as an own widget for your posts and pages!
== Description ==
The Dexs Navigation Tree is a small "Table of Content" (TOC) container. You can use it as an own widget or with the
shortcode `[dexs_toc]` direct in your posts and pages!
You can now configure the default design of your TOC container through the new administration page 'Dexs Navigation Tree'
under 'Settings'. It's also still possible to configure each TOC container for himself, use therefore also the administration
page (Use the button 'Generate Shortcode') or go to the faq section to see how it works manually.
= How it works? =
It generates automatically a "Table of Content" list with the content heading tags h1 - h6. But it is now also possible to
make your own list by using the TOC class names (anchor-1 to anchor-6) inside a span, p, div, i, b, strong or section element.
(Go to the FAQ section for more informations)
= New in version 1.2.0 =
* A own Administration Page with a shortcode generator
* Add the post title as first list-item
* A few more configuration settings
More informations under 'Changelog'.
= Features =
* A TOC Shortcode for your posts and pages
* A TOC Widget for your main sidebar
* Many design settings with 4 list style types
* Anchor linking inside the toc box
= Demo =
Go to [our website](http://www.pytes.net/demo/dexs-navigation-tree) to see a demonstration.
= Thanks To =
[Deadpool](https://profiles.wordpress.org/deadpool13) for the Bug Report and the Post-Title idea.
== Installation ==
1. Upload the `dexs-navigation-tree` folder to your `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Add the `Table of Contents` Widget to your Sidebar or
1. insert the `[dexs_toc]` shortcode to your posts and pages
== Screenshots ==
1. The default toc-container design, tested on our own template.
2. The default toc-container design, tested on Twenty Fourteen.
3. The administration page and the widget settings.
== Changelog ==
= 1.2.0 =
* Add: A new System Class (Widget Class moved to System Class)
* Add: A administration page with a JS shortcode generator
* Add: A few more configuration settings
* Update: The TOC widget
* Update: The TOC-List design
* Update: The TOC-List rendering
* Remove: The Post / Page restriction
* Remove: The "Anchor Above" (Jump above the title) option
* Remove: The folder icon (The Dashicons Font will used now)
= 1.1.0 =
* Add: A Shortcode function for posts and pages
* Update: The plugin description
* Update: The CSS file
* Update: The PHP class system
* Bugfix: The incorrect listing
= 1.0.0 =
* First stable version
== Frequently Asked Questions ==
= How do I embed? =
Write the following shortcode on the top of your posts and pages.
`[dexs_toc]`
Or move the "Table of Contents" widget to your main sidebar.
= How can i design? =
Use the shortcode generator on the administration page ('Settings' -> 'Dexs Navigation Tree') or use the following attributes inside the *[dexs_toc]* shortcode:
**New in 1.2.0**
`type="h"`
* Options: "h" | "c"
* Info: Change the content list type (See "How can i control?" below for more infos)
`post_title=true`
* Options: true | false
* Info: Use the post title as first-item
`post_sub=false`
* Options: true | false
* Info: Suborder all other items under the post title (requires post_title=true)
`colors="default,default,default"`
* Options: "font,link,link:hover"
* Info: Costumize the font link and link:hover color
`css=""`
* Info: Design your container with own CSS-codes
**Since 1.1.0**
`title="Table of Contents"`
* Info: Change the title
`align="right"`
* Options: "right" | "left" | "none" | "center"
* Info: Change the container position
`anchor=true`
* Options: true | false
* Info: Dis/Enable the anchor-linking
`tag="ul"`
* Options: "ul" | "ol"
* Info: Change the HTML list tag
`design="level_num"`
* Options: "num" | "level_num" | "folder" | "folder_num"
* Info: Change the list style type
`border="1px solid #d0d0d0"`
* Options: "width style color"
* Info: Costumize the border design
`background="transparent"`
* Options: "color"
* Info: Costumize the background-color
= How can i control? =
You have 2 options since version 1.2.0.
**Option 1: Heading Elements**
Use the content heading elements <h1> - <h6> (You don't have to start with <h1>).
*Example*
`[dexs_toc type="h"]
Title 1
Title 2
`
**Option 2: Class Names**
Use the class names "anchor-1" up to "anchor-6" inside a <span>, <p>, <div>, <i>, <b>, <strong> or <section> element.
Now you can display a different title between the post content and the TOC Container. (If you need this).
PS.: The element with the "anchor-*" class name will removed, so don't insert more then the TOC title!
*Example*
`[dexs_toc type="c"]
My TOC Title 1
My Post Title 1
My TOC Title 2
My Post Title 2
`
= How does work the widget? =
The widget will show automatically on post and pages (is_page() && is_post()). If you need special settings, use The [Widget Logic](https://wordpress.org/plugins/widget-logic "WordPress.org Plugin Link")
WordPress Plugin to define exactly where the widget should display and where not.
== Upgrade Notice ==
Nope