r9 - 2002-09-20 - 15:25:08 - ColasNahabooYou are here: NTP >  TWiki Web > NavbarPlugin
NTP users are strongly urged to take immediate action to ensure that their NTP daemons are not susceptible to being used in distributed denial-of-service (DDoS) attacks. Please also take this opportunity to defeat denial-of-service attacks by implementing Ingress and Egress filtering through BCP38.

ntp-4.2.8p13 was released on 07 March 2019. It addresses 1 medium-severity security issue in ntpd, and provides 17 non-security bugfixes and 1 other improvements over 4.2.8p12.

Please see the NTP Security Notice for vulnerability and mitigation details.

Are you using Autokey in production? If so, please contact Harlan - he's got some questions for you.

A navigation bar plugin

Add "Previous, Up To Contents & Next" navigation icons or text to TWiki topics.

Principle

If a topic contains the key %NAVBARINDEX%, it is parsed on save for bullet lines starting with an existing topic name, between the lines containing the keywords %NAVBARINDEX% and %NAVBARINDEXEND% (if present, or end of topic), which creates an index to the topics. (named .navbarcache in each web). Example:
%NAVBARINDEX%
   * FirstSubTopic optionnally followed by some text
   * SecondSubTopic with some other text

Indexed topics then has the tag %NAVBAR% expansed into a navigation bar. (of the form Prev Up Next, links to previous topic, index topic and next topic). This tag should be normally part of the skin template, you do not have to add them to your topics by hand.

It works by maintaining a cache of indexed topics in the web, updated when saving the topics. It thus needs for the Dec 2001 release a patch to add a plugin hook on save functionality that will be present in the next stable release (Falll 2002): TWiki:Codev/PluginHookOnSavePatch

It was inspired by the NavPlugin , with the following features:

  • No need to add special tag in indexed pages: only once in the index
  • Faster: NavPlugin could double rendering time of big pages

The %NAVBAR% tag can accept options, of the form:

   %NAVBAR{prefix="html code..." suffix="html code..." graphics="on"}%
  • If NAVBAR is expansed, it will be prefixed and suffixed by the corresponding arguments, if any
  • if graphics is not specified, the navbar is in text form, as Prev Up Next links. If set to on, it will use icons. Text will be striked out and icons will be greyed out When there is no previous or no next topic.
    graphics can be either the keyword on, or a string XXX that will be used to get the URL of a set of images, by appending -next,gif, -nexti.gif, ....
    The default, graphics="on" implies for instance:
    Plugins/NavbarPlugin/nav
  • another optional argument is size, giving additionnal parameters to the img tag for html icons when you use the graphics parameter, to giveheight and width for faster rendering for instance. Its default value (when using graphics="on" is:
    size="width=16 height=16"

See NavbarPluginExample at http://koala.ilog.fr/wiki/bin/view/Plugins/NavbarPluginExample

Plugin Installation Instructions

  • Download the ZIP file from the Plugin web (see below)
  • Unzip NavbarPlugin.zip in your twiki installation directory.
  • Test if the plugin is correctly installed, by
  • If you want to use it, modify your skin templates to include %NAVBAR% where you want
In the standard TWiki skin, you may want to edit templates/view.tmpl, to add two lines:
   %NAVBAR{prefix="<div align=right>" suffix="</div>"%
one just before the %TEXT% line, one just before the %META{"attachments"}% line

Known Issues/Limitations

  • All pages referenced in the index must be in the same web as the index page.
  • There is a possible race condition if 2 people save at the same time an index topic in the same Web. Re-saving them should do the trick.
  • Moving / Renaming the index or the topics is not handled. If anything goes wrong, just removing the .navbarcache and re-saving every index topic will fix thing.
  • Creating an entry for a non-existing topic in the index, then creating the topic will not work (as the file do not exists yet as the time of index save). Just edit/save the index once when all topics are defined to be sure.

Plugin Info

Plugin Author: ColasNahaboo
Plugin Version: v1.1
Change History: v1.0, 11 Sep 2002: Initial version
v1.1, 12 Sep 2002: size parameter, better examples
v1.2, 20 Sep 2002: Topics with numbers in their names were not indexed
CPAN Dependencies: none
Other Dependencies: none
Perl Version: 5.0
Plugin Home: http://TWiki.org/cgi-bin/view/Plugins/NavbarPlugin
Feedback: http://TWiki.org/cgi-bin/view/Plugins/NavbarPluginDev

Files

  • lib/TWiki/Plugins/NavbarPlugin.pm
  • data/Plugins/NavbarPlugin.txt
  • data/Plugins/NavbarPluginExample.txt
  • data/Plugins/NavbarPluginExampleFirst.txt
  • data/Plugins/NavbarPluginExampleMiddle.txt
  • data/Plugins/NavbarPluginExampleLast.txt
  • pub/Plugins/NavbarPlugin/nav-next.gif
  • pub/Plugins/NavbarPlugin/nav-nexti.gif inactive (greyed out) version.
  • pub/Plugins/NavbarPlugin/nav-prev.gif
  • pub/Plugins/NavbarPlugin/nav-previ.gif inactive (greyed out) version.
  • pub/Plugins/NavbarPlugin/nav-up.gif
  • pub/Plugins/NavbarPlugin/nav-upi.gif inactive (greyed out) version.

-- ColasNahaboo - 11 Sep 2002

Topic attachments
I Attachment Action Size Date Who Comment
gifgif nav-next.gif manage 0.1 K 2002-09-11 - 09:35 UnknownUser next topic icon
gifgif nav-nexti.gif manage 0.1 K 2002-09-11 - 09:36 UnknownUser next topic icon (inactive)
gifgif nav-prev.gif manage 0.1 K 2002-09-11 - 09:36 UnknownUser previous topic icon
gifgif nav-previ.gif manage 0.1 K 2002-09-11 - 09:36 UnknownUser previous topic icon (inactive)
gifgif nav-up.gif manage 0.1 K 2002-09-11 - 09:37 UnknownUser up / index icon
gifgif nav-upi.gif manage 0.1 K 2002-09-11 - 13:58 UnknownUser up / index icon (inactive
Edit | WYSIWYG | Attach | Printable | Raw View | Backlinks: Web, All Webs | History: r9 < r8 < r7 < r6 < r5 | More topic actions
 
This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding NTP? Send feedback
Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.NavbarPlugin