FS#2922 New Protocol für PARSER_WIKITEXT_PREPROCESS

Plugins

• 

  2014-01-22 ameise

  Currently the sequence of action plugins is undefined. That means, that the result of two plugins, that respond to PARSER_WIKITEXT_PREPROCESS meight also be undefined.
  
  To fix this, I want to propose a new protocol for PARSER_WIKITEXT_PREPROCESS (or a new event with same functionality):
  
  1. Handlers are still called in arbitrary sequence.
  2. Handlers return true, if the raw text has been changed; false otherwise.
  3. DW's event controller ors all handler results.
  4. If the ored result of all handlers is true, the list of handlers is executed once more, until no handler modified the text. A new parameter communicates the pass number to the handler.
• 

  2014-02-15 ChrisS

  Per a chat I had with splitbrain (maybe at a developer irc chat).
  
  We can add a new '$sequence' parameter to the Doku_Event_Handler::register_hook().  The parameter will come after $param and default to (int)0.
  
  When and event is processed its handlers will be called in sequence order.  If two handlers have registered using the same sequence number, the order in which they will be called will is undefined.
• 

  2014-02-16 ChrisS

  per above comment, see PR#552 - https://github.com/splitbrain/dokuwiki/pull/552
• 

  2014-02-16 ChrisS

  at least not as described -- see PR#552 & PR#555