Differences

This shows you the differences between two versions of the page.

--- plugin:sectiontoggle [2020-02-05 05:57] – Version upped Aleksandr
+++ plugin:sectiontoggle [2023-12-31 18:13] (current) – [sectiontoggle Plugin] 24.78.8.122
@@ Line 3: / Line 3: @@
 ---- plugin ----
 description: Toggle sections open and closed by clicking on section headers; change templates where needed for phones and tablets
-author     : Myron Turner
+author     : Myron Turner, Elbie M
-email      : turnermm02@shaw.ca
+email      : emoonga1993@gmail.com
 type       : action,syntax
-lastupdate : 2019-12-25
+lastupdate : 2023-12-27
-compatible : 2012-10-13 "Adora Belle", 2013-05-10a "Weatherwax", 2014-09-29b "Hrun", Detritus, Eleonor Of Tsort, Frusterick Manners, Greebo
+compatible : 2012-10-13 "Adora Belle", 2013-05-10a "Weatherwax", 2014-09-29b "Hrun", Detritus, Eleonor Of Tsort, Frusterick Manners, Greebo, Hogfather,Igor
 depends    :
 conflicts  :
@@ Line 13: / Line 13: @@
 tags       : mobile, tablet, phone, collapsible, hide, section, template
-downloadurl: https://github.com/turnermm/sectiontoggle/archive/master.zip
+downloadurl: https://github.com/Elbie-em/sectiontoggle/archive/refs/heads/master.zip
 bugtracker : https://github.com/turnermm/sectiontoggle/issues
 sourcerepo : https://github.com/turnermm/sectiontoggle
@@ Line 37: / Line 37: @@
 === Toggling ===
-When installed, the sections will initially be closed. Clicking on a header will open the section immediately below the header. Clicking on it again will close the section. Using the two buttons described [[#syntax|below]], the user can open and close all the sections with a single click.
+When installed, the sections will initially be closed, except as described below under #Auto-Toggling. Clicking on a header will open the section immediately below the header. Clicking on it again will close the section. Using the two buttons described [[#syntax|below]], the user can open and close all the sections with a single click.
+=== Auto Toggling ===
+There are two situations where a toggled section will remain open __when a page loads__. This enables you to link to a section of a page and that section will be open when the page loads.
+  - When the url accessing the page contains a hash element referencing a page section.  For instance: ''%%[[wiki:dokuwiki#read_more]]%%.'' This link will go to the ''read more section'' of the page and the section will be open and ready for reading.
+  - When the ''h_ini_open'' option is set.  For instance: \\ ''Welcome to your new DokuWiki;;DokuWiki Intro;;Read More''. \\  With this setting, when ''wiki:dokuwiki'' loads, two sections will remain open: **DokuWiki Intro** and ** Read More ** and when ''wiki:welcome'' loads the topmost ** Welcome to your new DokuWiki ** will be open.
+The Dokuwiki table of contents also benefits from auto toggling.  That is, when you click on a heading in the table of contents, not only will the page be directed to the heading, but the section will toggle open.
 === Disabling Toggles ===
@@ Line 45: / Line 51: @@
 {{ https://i.imgur.com/1iniJSO.png }}
-===== Syntax =====
+===== Using the Action Menu Button =====
+As an alternative to the traditional sidebar syntax for open and close buttons, this plugin now offers a more convenient option. Users can opt to use a toggle button located directly in the action menu of the page.
+This feature enhances user experience by providing a streamlined and accessible way to control section visibility without the need for additional syntax.
+To enable the action menu button:
+  - Navigate to the plugin configuration settings.
+  - Locate the option labeled **"Show Section Toggle Button"**.
+  - Enable this option to display the toggle button in the action menu.
+Note: Enabling this feature will replace the need for sidebar syntax for opening and closing sections. Users can still use the traditional method if preferred.
+===== Using Syntax =====
 ==== Toggle Buttons ====
@@ Line 54: / Line 75: @@
 These buttons will be hidden if toggling is disabled using the ''suspend'' option, as described below under Configuration.
+==== Limiting toggles to a section of the page ====
+The following two macros will mark the start and end of an enclosing ''DIV'' within which headers will be converted to toggles.  Headers elsewhere on the page will not have toggles attached to them.
+    ~~stoggle_openDIV~~
+    ~~stoggle_closeDIV~~
+These should not cross ''DIV'' boundaries. I.E.
+    DIV 1
+    DIV section__toggle
+    Div 1 closed
+    DIV section__toggle closed.
 ===== Configuration =====
-^  option      ^  options           ^  default                                                                   ^  description                                                                                          ^
+^  option        ^  options           ^  default  ^  description                                                                                                                                                                        ^
-| platform     | all, mobile, none  | all                                                                        | Selects the platform(s) on which to implement section toggling.                                       |
+| platform       | all, mobile, none  | mobile    | Selects the platform(s) on which to implement section toggling.                                                                                                                     |
-| type         | none,id,class      | none                                                                       | Indicates whether the div which encloses the affected headers is identified by a class or an id.      |
+| type           | none,id,class      | none      | Indicates whether the div which encloses the affected headers is identified by a class or an id.                                                                                    |
-| name         |                    |   | Name of the class or id which identifies the enclosing div.                                           |
+| name           |                    |           | Name of the class or id which identifies the enclosing div.                                                                                                                         |
-| headers      | h1-h6              | h4                                                                         | Smallest header to activate as toggle. All headers between h1 and this setting will be toggles.       |
+| headers        | h1-h6              | h4        | Smallest header to activate as toggle. All headers between h1 and this setting will be toggles.                                                                                     |
-| suspend      | 1,0                | 0                                                                          | If set to true the plugin will be inactivated and no toggles will be set.                             |
+| suspend        | 1,0                | 0         | If set to true the plugin will be inactivated and no toggles will be set.                                                                                                           |
-| xcl_headers  |                    |                                                                            | Checkboxes to select headers which should not be set as toggles                                       |
+| xcl_headers    |                    |           | Checkboxes to select headers which should not be set as toggles                                                                                                                     |
-| mobile_alt   |                    |                                                                | An alternate template installed for phones, in case your preferred template does not support phones.  |
+| mobile_alt     |                    |           | An alternate template installed for phones, in case your preferred template does not support phones.                                                                                |
-| tablet_alt   | 1,0                | 0                                                                           | Use the alternate template for tablets |
+| tablet_alt     | 1,0                | 0         | Use the alternate template for tablets                                                                                                                                              |
-|tablet_toggle| 1,0                |0              |Use toggles on tablets as well as phones|
+| tablet_toggle  | 1,0                | 0         | Use toggles on tablets as well as phones                                                                                                                                            |
-|xcl_ns| | |Comma separated list of namespaces to be excluded from toggles, without initial or final colons (i.e.  name:space , not :name:space: ) |
+| xcl_ns         |                    |           | Comma separated list of namespaces to be excluded from toggles, without initial or final colons (i.e.  name:space , not :name:space: )                                              |
-|xcl_pg| | |Comma separated list of page ids to be excluded from toggles (without initial colons, i.e  page:id, not :page:id )|
+| xcl_pg         |                    |           | Comma separated list of page ids to be excluded from toggles (without initial colons, i.e  page:id, not :page:id )                                                                  |
-|incl_ns| | | Comma separated list of namespace ids where toggles should appear (without initial colons). Takes precedence over ''xcl_ns'', ''xcl_pg'', and ''incl_pg''.|
+| incl_ns        |                    |           | Comma separated list of namespace ids where toggles should appear (without initial colons). Takes precedence over ''xcl_ns'', ''xcl_pg'', and ''incl_pg''.                          |
-|incl_pg| | | Comma separated list of page ids where toggles should appear (without initial colons). Takes precedence over ''xcl_ns'' and ''xcl_pg''.|
+| incl_pg        |                    |           | Comma separated list of page ids where toggles should appear (without initial colons). Takes precedence over ''xcl_ns'' and ''xcl_pg''.                                             |
+| h_ini_open     |                    |           | List of header texts, separated by double semi-colons, where toggles should stay open when the page loads, i.e. \\ ** header-text;;header-text;;. . .**                             |
+| toc_toggle     | true/false         | false     | When true, clicking on an entry in the TOC will not toggle the selected header but will, as in the default Douwiki configuration, direct the cursor to the header's page location.  |
+| start_open     | true/false         | false     | Load page into browser with all toggles open (they can then be closed and opened as usual)                                                                                                                                          |
 ==== Notes on the Options ====
@@ Line 79: / Line 112: @@
       * ''none''  : toggling is disabled on all platforms.
     * **Name and Type**
-      * The ''type'' is either an id or a class and the ''name'' the id or class attribute of the divs which govern the headers. If you are using the DokuWiki template or one of the templates listed in [[#templatesinipreconfigured_templates|templates.ini]], the plugin automatically detects the template and will use the appropriate settings. In the case of the ''templates.ini'' file, ''type'' must be set to ''none'' or the file will be ignored.
+      * The ''type'' is either an id or a class, and the ''name'' is the id or class name of the divs which govern the headers. If you are using the DokuWiki template or one of the templates listed in [[#templatesinipreconfigured_templates|templates.ini]], the plugin automatically detects the template and will use the appropriate settings. In the case of the ''templates.ini'' file, ''type'' must be set to ''none'' or the file will be ignored.
     * **Headers and xcl_headers**
-      * The headers option selects the smallest header to be converted to a toggle. If you choose h6, all headers between h1 and h6 will be converted to toggles. You can, however, use the xcl_headers setting to omit selected headers from being converted to toggles.
+      * The headers option selects the smallest header to be converted to a toggle. If you choose h6, all headers between h1 and h6 will be converted to toggles. You can, however, use the ''xcl_headers'' setting to omit selected headers from being converted to toggles. In this case, the section below the header will remain permanently visible.
     * **mobile_alt**
       * When ''platform'' is set to ''all'' or ''mobile'', this option enables you to switch to an alternate template that supports phones, in the event that your preferred template does not.  If your preferred template does support phones, then set this option to blank. A check is made to insure that that  alternate template is correctly installed, and if not the main template is used.
     * **tablet_alt**
       * If set to true the ''mobile_alt'' template will be used for tablets.
+    * **start_open**
+      * This option will not apply to mobile devices or to logged in users without edit permission.
 When the toggle buttons are included on a page, they will not display if the platform is excluded from section toggling. So, if you want toggling only on mobile devices, you can still include these buttons on your page but they will not display on standard desktop systems.
@@ Line 122: / Line 155: @@
 === Preconfigured Templates ===
-  - 20cones
+  - [[template:20cones]]
-  - adoradark
+  - [[template:adoradark]]
-  - arctictut
+  - [[template:arctictut]]
-  - bootstrap3
+  - [[template:bootstrap3]]
-  - dokucms
+  - [[template:dokucms]]
-  - flat
+  - [[template:flat]]
-  - greensteel
+  - [[template:greensteel]]
-  - kajukkk
+  - [[template:kajukkk]]
-  - minima
+  - [[template:minima]]
-  - monochrome
+  - [[template:monochrome]]
-  - prsnl10
+  - [[template:prsnl10]]
-  - sprintdoc
+  - [[template:sprintdoc]]
-  - twentyfifteen
+  - [[template:twentyfifteen]]
-  - wallpaper
+  - [[template:wallpaper]]
-  - white
+  - [[template:white]]
-  - writr
+  - [[template:writr]]