wiki:advanced_plugin

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
wiki:advanced_plugin [2023/02/18 06:43] – removed - external edit (Unknown date) 127.0.0.1wiki:advanced_plugin [2023/02/18 06:43] (current) – ↷ Page moved from contributing:advanced_plugin to wiki:advanced_plugin suedunham
Line 1: Line 1:
 +====== Advanced plugin ======
 +[[doku>plugin:advanced|Advanced plugin page]]
 +
 +This provides three main functions available on the Admin page under ''Additional Plugins'': ''Advanced Configurations'', ''Export Utility'', and ''Import Utility''.
 +
 +===== Advanced Configurations =====
 +
 +This gives access via the wiki interface to many of the configuration files normally only reached from the back end. The present editor was long baffled by it though, since the Admin page button opens up a blank page. The functionality of it all is hidden in a dropdown menu resembling the normal wiki page Table of Contents at the right.
 +
 +Not all are currently in use, but here are some remarks on those that are.
 +
 +==== Configurations ====
 +
 +This gives access to files in the ''/conf'' directory of the wiki. There is always a default file named like ''acronyms.conf'', and it is best to leave these alone. A second file can be created, like ''acronyms.local.conf'', to hold additional custom content. Of particular note are the following.
 +
 +^ Button ^ File ^ Use ^
 +| Abbreviations and Acronyms | ''acronyms.local.conf'' | This opens up a popup with a definition of an acronym when hovering over it. It has been pressed into service as a quick glossary of Hârnic terms. Due to the file format, only the first word can be used this way, so two-word terms like "Rion Ishar" glitch. |
 +| Entities | ''entities.local.conf'' | **Not in use.** This handles text replacements, like three hyphens in the editor resulting in an em dash on the page. While all the defaults are present, a notion of using this to add accents to Hârnic terms was abandoned. |
 +| Interwiki Links | ''interwiki.local.conf'' | This sets up interwiki links for wiki-style typing and---elsewhere in CSS---custom icons for some external links. An example wold be the link to the plugin page above, written ''%%[[doku>plugin:advanced]]%%''. A handful have been added. |
 +| Smileys | ''smileys.local.conf'' | Add more of these: :-D. The Flumph has been stolen from [[https://www.dragonsfoot.org/forums/index.php|the Dragonsfoot forum]]. |
 +| Template style.ini | ''style.ini'' | This links the CSS files used by the wiki and holds the color defaults modified with the Template Style Settings page. |
 +
 +==== CSS Styles ====
 +
 +One way of tweaking the look of the wiki is with a file like those above, ''userstyle.css''. This approach is not used in HârnWiki, which uses a customized template instead.
 +
 +==== Template Hooks ====
 +
 +This allows for HTML or PHP to be added to particular page locations, like the header, footer, etc. These have not been customized at the present time.
 +
 +==== Others ====
 +
 +This allows for adjusting the ''.htaccess'' files used by the internet thing to do internet stuff that the present editor does not understand.
 +
 +===== Export Utility =====
 +
 +This allows for exporting all or some of the wiki pages. Unfortunately, only the pages themselves are exported without any metadata, such as the original page creator.
 +
 +Leaving the dropdown unchanged and displaying "Select the Namespace", and ticking the ''Include sub-namespaces'' checkbox exports all of the pages.
 +
 +===== Import Utility =====
 +
 +This allows for importing pages arranged as the output of the Export Utility. The present editor has not been able to use this successfully, though that was some time ago and the plugin has been updated since.