~~NOCACHE~~
====== The Puzzlers' Wiki ======

This Wiki implements a number of customizations by the webmasters from others and for the requirements of the Members of the League.  We have a [[webmaster:todo|ToDo Page]] as well for unresolved issues.

We've found the following other resources very helpful:
  * [[http://www.robmeerman.co.uk/unix/unison|Rob Meerman's Unison Dokuwiki]] has some great help with fixing permissions and ownership in a DokuWiki.

===== Accomplishments =====

==== PHP Forms ====

There are a number of areas where a PHP form or page was required but, for security reasons, not entirely desirable.  The Wiki implementation, as we retrieved it from [[http://wiki.splitbrain.org/wiki:dokuwiki|the DokuWiki site]] in Aug/2005, allows global PHP code to be enabled in the configuration, but that has the problem of anyone who can edit the site can execute code ... so, you either heavily restrict edits or you prohibit PHP in pages.

We considered both of these options unsatisfactory.  Why have a Wiki if no one can edit?  But we still need forms.  

Therefore we designed a solution: a third "data directory" similar to pages (which can be edited) and media (which can be uploaded) that contains PHP forms.  This required, for the most part, only a bit of additional code to find and inject the form.

I'm compiling separate [[puzzler_forms|notes to document the forms changes]].

==== Counters ====

We implemented the modifcation to for [[http://wiki.erazor-zone.de/doku.php?id=wiki:projects:php:dokuwiki:counter|Page Counters]].

==== Sidebar ====

We have implemented the Sidebar code from [[http://wiki.jalakai.co.uk/dokuwiki/doku.php]] for the 2005-07-13 release.

==== Manage User Profiles ====

We have implemented the Profile Management code from [[http://wiki.splitbrain.org/wiki:discussion:manageprofile|wiki:discussion:manageprofile]] for the 2005-07-13 release.  This allows users to change their own passwords and update an email address stored on the website.

==== Base Links ====

We have implemented the Base Links change from [[http://wiki.splitbrain.org/wiki:tips:base_links|wiki:tips:base_links]].  This permits reference to the [[/guide|Guide to the Enigma]].  FIXME: these internal links should NOT open in a new window -- they should remain in the same window just like any "internal links."

==== Enhancements ====
  * changes to the xhtml_parser object to support::
    * Added a background function for external links (added the $returnonly parameter as was done for internal links).
    * Added a background function for email links (added the $returnonly parameter as was done for internal links).

==== Minor hacks ====
  * Using code from [[http://linuxbasics.org/making/lbowiki]] to change inc/common.php, the Playground is no longer tracked in the change log.
<code>
/**
 * Add's an entry to the changelog
 *
 * @author Andreas Gohr <andi@splitbrain.org>
 */
function addLogEntry($date,$id,$summary=""){
  global $conf;
  $id     = cleanID($id);//FIXME not needed anymore?

/**Keep playground out of changelog**/
  if(preg_match ("/playground/","$id")){
    return;
  } /**end of playground section **/  
 
</code>

==== Implemented Wiki:Orphans_And_Wanted ====

[[wiki:orphans_and_missing]] lists all the links on the site and the link counts.  The lists are 
broken into two groups:
  * Missing pages have links but do not exist -- these should be created.
  * Orphans: existing pages with 0 links -- this should be related to //something// on the site.
  * This has been upgraded to a plugin for Dokuwiki to reduce maintenance (Mar/2006).

===== Wish List =====
  * <del>FIXME We need a way to define anchors without headings.  For example, in the [[krewe:faq:start|FAQ]], we want to add an "answer" about "googlewhacking, and would like to be able to add a reference to the question/answer //without// making a heading in the text.  Similar problems exist with the [[secure:census:report1|Census]].</del>
  * FIXME clean all the stuff off the [[webmaster:todo|"To Do list"]]

===== HOWTO: =====

==== Named Anchors ====
Use this style to create simpler names for Anchors:
<code>
    <html><a name="--my name--"></a></html>
</code>
This anchor should appear //before// the heading, if any, you are marking.

Whenever you create a heading, you also create a named anchor with:
  * no leading or trailing whitespace
  * internal spaces are changed to underscores
  * reserved characters are changed to underscores
  * all characters are lowercase.

------
~~booknav>~~