> </tr>
> <tr>
> <td align="right"> Version: </td>
-> <td> 15675 (04 Aug 2008) </td>
+> <td> 15675 (06 Dec 2008) </td>
> </tr>
> <tr>
> <td align="right"> Dependencies: </td>
</tr>
<tr>
<td align="right"> Plugin Version: </td>
- <td> 03 Aug 2008 17302 (04 Aug 2008) </td>
+ <td> 03 Aug 2008 17302 (06 Dec 2008) </td>
</tr>
<tr>
<td align="right"> Change History: </td>
<table border="1" cellpadding="0" cellspacing="0">
<tr>
<td align="right"> Plugin Author: </td>
- <td> TWiki:Main/PeterThoeny </td>
+ <td> Arthur Clemens, TWiki:Main/PeterThoeny </td>
</tr>
<tr>
<td align="right"> Copyright: </td>
- <td> © 2002-2008, TWiki:Main.PeterThoeny (<a href="http://www.twiki.net/" target="_top">TWIKI.NET</a>) and TWiki Contributors </td>
+ <td> © 2008 Arthur Clemens, 2002-2008 TWiki:Main.PeterThoeny (<a href="http://www.twiki.net/" target="_top">TWIKI.NET</a>) and TWiki Contributors </td>
</tr>
<tr>
<td align="right"> License: </td>
</tr>
<tr>
<td align="right"> Plugin Version: </td>
- <td> 4.8.4 (03 Aug 2008) </td>
+ <td> 4.9 (01 Nov 2008) </td>
</tr>
<tr>
<td align="right"> Change History: </td>
<td> </td>
</tr>
<tr>
+ <td align="right"> 01 Nov 2008: </td>
+ <td> 4.9: Arthur Clemens: Fixed rendering of <code>verbatim</code> blocks when editing. Added parameter <code>buttonrow="top"</code> to allow the buttons to be positioned at the top of the table. </td>
+ </tr>
+ <tr>
+ <td align="right"> 26 Sep 2008: </td>
+ <td> 4.8.7: Arthur Clemens: Let empty table initialize more than one column from <code>header</code> parameter </td>
+ </tr>
+ <tr>
+ <td align="right"> 24 Sep 2008: </td>
+ <td> 4.8.6: Arthur Clemens: Fix parsing of header labels </td>
+ </tr>
+ <tr>
+ <td align="right"> 21 Sep 2008: </td>
+ <td> 4.8.5: Arthur Clemens: Fix rendering of TML inside label </td>
+ </tr>
+ <tr>
<td align="right"> 03 Aug 2008: </td>
- <td> 4.8.4 TWiki 4.2.1 release version </td>
+ <td> 4.8.4: TWiki 4.2.1 release version </td>
</tr>
<tr>
<td align="right"> 19 Jul 2008: </td>
- <td> 4.8.3 Bugfix release </td>
+ <td> 4.8.3: Bugfix release </td>
</tr>
<tr>
<td align="right"> 20 Mar 2008: </td>
</tr>
<tr>
<td align="right"> Plugin Version: </td>
- <td> 15942 (04 Aug 2008) </td>
+ <td> 15942 (06 Dec 2008) </td>
</tr>
<tr>
<td align="right"> Change History: </td>
</tr>
<tr>
<td><code>$date</code></td>
- <td> Time stamp of last topic update, e.g. <code>29 Jun 2010 - 16:07</code></td>
+ <td> Time stamp of last topic update, e.g. <code>29 Jun 2010 - 16:13</code></td>
</tr>
<tr>
<td><code>$isodate</code></td>
- <td> Time stamp of last topic update, e.g. <code>2010-06-29T16:07Z</code></td>
+ <td> Time stamp of last topic update, e.g. <code>2010-06-29T16:13Z</code></td>
</tr>
<tr>
<td><code>$rev</code></td>
<form action="%SCRIPTURLPATH{"view"}%/%WEB%/%TOPIC%">
Find Topics:
- <input type="text" name="q" size="32" value="%URLPARAM{"q"}%" /> <input type="submit" class="twikiSubmit" value="Search" />
+ <input type="text" name="q" size="32" value="%URLPARAM{"q" encode="entity"}%" /> <input type="submit" class="twikiSubmit" value="Search" />
</form>
Result:
- %SEARCH{ search="%URLPARAM{"q"}%" format=" * $web.$topic: %BR% $summary" nosearch="on" }%
+ %SEARCH{ search="%URLPARAM{"q" encode="quote"}%" type="keyword" format=" * $web.$topic: %BR% $summary" nosearch="on" }%
**To get this:**
</tr>
<tr>
<td align="right"> Plugin Version: </td>
- <td> 03 Aug 2008 17302 (04 Aug 2008) </td>
+ <td> 03 Aug 2008 17387 (06 Dec 2008) </td>
</tr>
<tr>
<td align="right"> Change History: </td>
You can also use the calendar directly in your own hand-built forms, without having to write any code. Just add this inline in the topic text:
- %INCLUDE{"%SYSTEMWEB%/JSCalendarContribInline"}%
+ %INCLUDE{"%TWIKIWEB%/JSCalendarContribInline"}%
Then, to display a calendar icon next to a text input field:
<input type="text" id="cal_val_here" />
- <input type="image" src="%PUBURL%/%SYSTEMWEB%/JSCalendarContrib/img.gif" onclick="javascript: return showCalendar('cal_val_here','%e %B %Y')" />
+ <input type="image" src="%PUBURL%/%TWIKIWEB%/JSCalendarContrib/img.gif" onclick="javascript: return showCalendar('cal_val_here','%e %B %Y')" />
If the contrib is installed, you will see such a field here:
<input id="cal_val_here" type="text" />
- <input onclick="javascript: return showCalendar('cal_val_here','%e %B %Y')" src="http://www.dementia.org/twiki//view/%SYSTEMWEB%/JSCalendarContrib/img.gif" type="image" />
+ <input onclick="javascript: return showCalendar('cal_val_here','%e %B %Y')" src="http://www.dementia.org/twiki//view/TWiki/JSCalendarContrib/img.gif" type="image" />
### <a name="Installation Instructions"></a> Installation Instructions
</tr>
<tr>
<td align="right"> Version: </td>
- <td> 03 Aug 2008 </td>
+ <td> 17492 (06 Dec 2008) of the Mishoo calendar </td>
</tr>
<tr>
<td align="right"> Copyright ©: </td>
<td> None </td>
</tr>
<tr>
- <td align="right"> Change History: </td>
+ <td> Change History: </td>
<td> </td>
</tr>
<tr>
- <td align="right"> 03 Aug 2008 </td>
- <td> TWiki 4.2.1 release version incl new calendar icon </td>
+ <td align="right"> 10 Sep 2008 </td>
+ <td> Bugs:Item5991 Applied patch to fix rendering on IE7 . </td>
</tr>
<tr>
- <td align="right"> 6 Sep 2007 </td>
+ <td align="right"> 06 Sep 2007 </td>
<td> Bugs:Item4030 Added doc for using the calendar in user forms </td>
</tr>
<tr>
</tr>
<tr>
<td align="right"> 5039 </td>
- <td> Split from [[Main/SharedCode]]</td>
+ <td> Split from SharedCode </td>
</tr>
<tr>
<td align="right"> 27 Dec 2005 </td>
</tr>
<tr>
<td align="right"> 14 Aug 2004 </td>
- <td> Separated out from [[Main/SharedCode]] module </td>
+ <td> Separated out from SharedCode module </td>
</tr>
<tr>
<td align="right"> Home: </td>
</tr>
</table>
-**_Related Topics:_** %SYSTEMWEB%.TWikiPreferences
+**_Related Topics:_** [[TWikiPreferences]]
- **Using wild-card character in topic names** - You can use `*` in a topic name, where it is treated as a [wildcard character](http://en.wikipedia.org/wiki/Wildcard_character). A `*` will match zero or more other characters - so, for example, `Fred*` will match all topic names starting with `Fred`, `*Fred` will match all topic names _ending_ with `Fred`, and `*` will match _all_ topic names.
- **Unsubscribing to specific topics** - Each topic may optionally be preceded by a '+' or '-' sign. The '+' sign means "subscribe to this topic". The '-' sign means "unsubscribe" or "don't send notifications regarding this particular topic". This allows users to elect to filter out certain topics. Topic filters ('-') take precedence over topic includes ('+') i.e. if you unsubscribe from a topic it will cancel out any subscriptions to that topic.
- **Including child-topics in subscription** - Each topic may optionally be followed by an integer in parentheses, indicating the depth of the tree of children below that topic. Changes in all these children will be detected and reported along with changes to the topic itself. _Note_ This uses the TWiki "Topic parent" feature.
-- **Subscribing to entire topic ("news mode")** - Each topic may optionally be immediately followed by an exclamation mark ! or a question mark ? with no intervening spaces, indicating that the topic (and children if there is a tree depth specifier as well) should be mailed out as **complete topics** instead of change summaries. ! causes the topic to be mailed every time _even if there have been no changes_, and ? will mail the topic only if there have been changes to it. One can limit the content of the subscribed topic to send out by inserting %STARTPUBLISH% and %STOPPUBLISH% markers within the topic. Note that "news mode" subscriptions require a corresponding cron job that includes the "-news" option (see [[details|Main/TOPIC#Setting_up_your_cron_job_s]]).
+- **Subscribing to entire topic ("news mode")** - Each topic may optionally be immediately followed by an exclamation mark ! and/or a question mark ? with no intervening spaces, indicating that the topic (and children if there is a tree depth specifier as well) should be mailed out as **complete topics** instead of change summaries. ! causes the full topic to be mailed every time _even if there have been no changes_, and ? will mail the full topic only if there have been changes. One can limit the content of the subscribed topic to send out by inserting %STARTPUBLISH% and %STOPPUBLISH% markers within the topic. Note that "news mode" subscriptions require a corresponding cron job that includes the "-news" option (see [[details|Main/TOPIC#Setting_up_your_cron_job_s]]).
Examples: Subscribe Daisy to all changes to topics in this web.
If a _group_ is listed for notification, the group will be recursively expanded to the e-mail addresses of all members.
-\_\_%X% Warning: Because an email address is not linked to a user name, there is no way for TWiki to check access controls for email addresses. A user identified by an email address will only be sent change notifications if the topic they are asubscribed to is readable by guest users. You can limit what email addresses can be used in WebNotify, or even block use of emails altogther, using the `{MailerContrib}{EmailFilterIn} setting in =configure`.
+\_\_%X% Warning: Because an email address is not linked to a user name, there is no way for TWiki to check access controls for subscribers identified by email addresses. A subscriber identified by an email address alone will only be sent change notifications if the topic they are subscribed to is readable by guest users. You can limit what email addresses can be used in %NOTIFYTOPIC%, or even block use of emails altogther, using the `{MailerContrib}{EmailFilterIn} setting in =configure`.
**_%T% Tip:_** List names in alphabetical order to make it easier to find the names.
## <a name="Developer Notes"></a> Developer Notes
-The changes mails sent to users are based on a TWiki template called `mailnotify`. This template must contain the following definitions.
+The changes mails sent to subscribers are based on a TWiki template called `mailnotify`. This template must contain the following definitions.
<table border="1" cellpadding="0" cellspacing="0">
<tr>
</tr>
<tr>
<td align="right"> Version: </td>
- <td> 03 Aug 2008 </td>
+ <td> 17629 (14 Oct 2008) </td>
</tr>
<tr>
<td align="right"> Change History: </td>
<td> </td>
</tr>
<tr>
+ <td align="right"> 14 Oct 2008 </td>
+ <td> TWikibug:Item6066: fixed issue for user mappings where cuid = login </td>
+ </tr>
+ <tr>
+ <td align="right"> 27 Aug 2008 </td>
+ <td> TWikibug:Item5949: fixed problem with unsubscribe that should result in an empty subscription </td>
+ </tr>
+ <tr>
<td align="right"> 03 Aug 2008 </td>
<td> TWiki 4.2.1 release version </td>
</tr>
<li><a href="#Change, Reset and Install Passwo"> Change, Reset and Install Passwords</a></li>
<li><a href="#Changing User Account Names"> Changing User Account Names</a></li>
<li><a href="#Removing User Accounts"> Removing User Accounts</a></li>
+ <li><a href="#Customizing registration Emails."> Customizing registration Emails.</a></li>
</ul>
</li>
</ul>
3. Remove `FredQuimby` from all groups and from all the `ALLOWWEB/ALLOWTOPIC...` declarations, if any.%BR% **_Note:_** If you fail to do this you risk creating a security hole, as the next user to register with the wikiname FredQuimby will inherit the old FredQuimby's permissions.
4. _[optional]_ Delete their user topic Main.FredQuimby (including attachments, if any.)
-**_Note:_** Consider leaving the user topic file in place so their past signatures and revision author entries don't end up looking like [[AnUncreatedTopic]]. If you want to make it clear the user is no longer around, replace the topic content with a note to that effect. The existance of the UserName topic should also prevent that user name from being re-used, sealing the potential security hole regarding inherited permissions..
+**_Note:_** Consider leaving the user topic file in place so their past signatures and revision author entries don't end up looking like [[AnUncreatedTopic]]. If you want to make it clear the user is no longer around, replace the topic content with a note to that effect. The existence of the UserName topic should also prevent that user name from being re-used, sealing the potential security hole regarding inherited permissions..
+
+## <a name="Customizing registration Emails."></a> Customizing registration Emails.
+
+TWiki's Registration can send 3 emails who's output is governed by templates:
+
+1. User registration confirmation - `templates/registerconfirm.tmpl`
+2. User registration notification - `templates/registernotify.tmpl`
+3. Email to notify the TWiki admin of registration - `templates/registernotifyadmin.tmpl`
+
+As these are [[TWikiTemplates]], they can be customized and selected using the SKIN path setting. Because there are default tmpl files in the `templates` dir, this cannot use Template topics.
+
+These template files have a specific format that matches the raw format of emails sent via SMTP, so be careful and test your changes. It is easiest to start by copying the default templates:
+
+ cd twiki/templates
+ cp registernotify.tmpl registernotify.myskin.tmpl
+ cp registerconfirm.tmpl registerconfirm.myskin.tmpl
+ cp registernotifyadmin.tmpl registernotifyadmin.myskin.tmpl
+
+then add `myskin` to the beginning of the `SKIN` setting in [[TWikiPreferences]].
+
+From this point on, your myskin templates will be used for the registration emails.
+
+To make it possible for [[TWikiUsers]] to modify the email contents, you could use a parameterized `%INCLUDE%` statement in your customized version. eg:
+
+ From: %WIKIWEBMASTERNAME% <%WIKIWEBMASTER%>
+ To: %FIRSTLASTNAME% <%EMAILADDRESS%>
+ Subject: %MAKETEXT{"[_1] - Registration for [_2] ([_3])" args="%WIKITOOLNAME%, %WIKINAME%, %EMAILADDRESS%"}%
+ MIME-Version: 1.0
+ Content-Type: text/plain; charset=%CHARSET%
+ Content-Transfer-Encoding: 8bit
+
+ %INCLUDE{
+ "Main.RegistrationNotification"
+ WIKINAME="%WIKINAME%"
+ FIRSTLASTNAME="%FIRSTLASTNAME%"
+ EMAILADDRESS="%EMAILADDRESS%"
+ }%
+
+- **_note the use of %WIKINAME%, %FIRSTLASTNAME%, %EMAILADDRESS% passed in from the INCLUDE so that the topic below is similar to the original template_**
+
+and then create a topic Main.RegisterNotifyEmail:
+
+ Welcome to %WIKITOOLNAME%.
+
+ %MAKETEXT{"Your personal [_1] topic is located at [_2]. You can customize it as you like:" args="%WIKITOOLNAME%, %SCRIPTURL{"view"}%/%USERSWEB%/%WIKINAME%"}%
+
+ * %MAKETEXT{"Some people turn it into a personal portal with favorite links, what they work on, what help they'd like, etc."}%
+ * %MAKETEXT{"Some add schedule information and vacation notice."}%
+
+ Regards
+ %WIKIWEBMASTERNAME%
+ Your TWiki Admin
+
+ %MAKETEXT{"Note:"}%
+ 2 %MAKETEXT{"You can change your password at via [_1]" args="%SCRIPTURL{"view"}%/%SYSTEMWEB%/ChangePassword"}%
+ 3 %MAKETEXT{"If you haven't set a password yet or you want to reset it, go to: [_1]" args="%SCRIPTURL{"view"}%/%SYSTEMWEB%/ResetPassword"}%
+
+ %MAKETEXT{"Submitted content:"}%
+ %FORMDATA%
+
+- **_remember to secure the topic appropriately to prevent attackers from getting emailed sensitive passwords._**
**_Related Topics:_** [[AdminDocumentationCategory]]
-# <a name="%SYSTEMWEB%._PatternSkin Customi"></a><a name=" %SYSTEMWEB%._PatternSkin Custom"></a> %SYSTEMWEB%.PatternSkin Customization
+# <a name="TWiki._PatternSkin Customization"></a><a name=" TWiki._PatternSkin Customizatio"></a> [[PatternSkin]] Customization
-**Questions and answers on configuring page elements.** For styling your TWiki, see [[PatternSkinCssCookbook]].
+**Guidelines how to create and customize page templates.** For styling your TWiki using stylesheets, see [[PatternSkinCssCookbook]].
<div>
<ul>
<li><a href="#I want to make the left bar wide"> I want to make the left bar wider</a></li>
</ul>
</li>
- <li><a href="#Other page parts"> Other page parts</a><ul>
+ <li><a href="#Buttons"> Buttons</a><ul>
<li><a href="#I want to hide the edit buttons"> I want to hide the edit buttons from certain users</a></li>
<li><a href="#I want to remove the History but"> I want to remove the History button from the bottom</a></li>
+ <li><a href="#I want to put the bottom links a"> I want to put the bottom links as buttons at the top</a></li>
+ </ul>
+ </li>
+ <li><a href="#Other page parts"> Other page parts</a><ul>
<li><a href="#I want to insert text outside of"> I want to insert text outside of the topic content</a></li>
<li><a href="#I want to place the form at the"> I want to place the form at the top</a></li>
- <li><a href="#I only want to show the WYSIWYG"> I only want to show the WYSIWYG button on explicit pages</a></li>
+ <li><a href="#I want to put the topic form in"> I want to put the topic form in a twisty</a></li>
</ul>
</li>
</ul>
2. Create a new (empty) view template file in `/templates` called `view.myskin.tmpl`.
3. In `view.myskin.tmpl` you write:
> %TMPL:INCLUDE{"view"}%
-> %TMPL:DEF{"topicactionbuttons"}%%TMPL:P{"activatable_more"}%%TMPL:END%
+> %TMPL:DEF{"top:toolbarbuttons"}%%TMPL:P{"more_link"}%%TMPL:END%
4. For testing, view any topic and append to the topic name: `?cover=myskin`. You should see an effect now.
5. To make the changes visible on all pages, go to [[Main.TWikiPreferences|Main/TWikiPreferences]] (to keep [[TWikiPreferences]] intact) and write:
We can use the same example as above. In a topic write:
> %TMPL:INCLUDE{"view"}%
-> %TMPL:DEF{"topicactionbuttons"}%%TMPL:P{"activatable_more"}%%TMPL:END%
+> %TMPL:DEF{"top:toolbarbuttons"}%%TMPL:P{"more_link"}%%TMPL:END%
You can also test this by appending `?template=PersonalInfoView` to the url.
## <a name="Reference: pattern skin template"></a> Reference: pattern skin template INCLUDE tree
+The `view` script invokes the `view` template:
+
view
- page
- constants
- javascript
- styles
- stylesdynamic
- body
- viewtopbar
- %SYSTEMWEB%.WebTopBar
- viewtoolbar
- viewleftbar
- %WEB%.WebLeftBar
- viewtopicactionbuttons
- viewbottombar
- %SYSTEMWEB%.WebBottomBar
+ twiki
+ css
+ viewtopbar
+ %TWIKIWEB%.WebTopBar
+ viewleftbar
+ %WEB%.WebLeftBar
+ viewtopicactionbuttons
+ viewbottombar
+ %TWIKIWEB%.WebBottomBar
## <a name="Logo"></a> Logo
**Using logo.gif:**
-> - Create a new image named `logo.gif` and attach it to the web's [[WebPreferences]] topic. %SYSTEMWEB%.PatternSkin's stylesheet assumes the logo is 40px high. More about that later.
+> - Create a new image named `logo.gif` and attach it to the web's [[WebPreferences]] topic. [[PatternSkin]]'s stylesheet assumes the logo is 40px high. More about that later.
> - You can also upload the image with FTP to `/pub/YourWeb/WebPreferences/`.
> - Copy the above instructions ("Redefine your custom variables") and insert your logo name.
### <a name="I want to change the white space"></a> I want to change the white space above and below the logo
-Change the table style in topic %SYSTEMWEB%.WebTopBar. The default top padding is 11px.
+Change the table style in topic [[WebTopBar]]. The default top padding is 11px.
## <a name="Top bar"></a> Top bar
>
> `USERLAYOUTURL`
>
-> to that topic attachment. See %SYSTEMWEB%.PatternSkinCssCookbook about creating custom styles.
+> to that topic attachment. See
+>
+> [[PatternSkinCssCookbook]]
+>
+> about creating custom styles.
### <a name="I want to set or change the top"></a><a name="I want to set or change the top "></a> I want to set or change the top background image
Redefine your custom variables in [[Main.TWikiPreferences|Main/TWikiPreferences]] (to keep [[TWikiPreferences]] intact):
-> * Set WEBHEADERART = %PUBURLPATH%/%SYSTEMWEB%/PatternSkin/TWiki_header.gif
+> * Set WEBHEADERART = %PUBURLPATH%/%TWIKIWEB%/PatternSkin/TWiki_header.gif
> * Set WEBHEADERBGCOLOR = somehexcolor (no quotes, for example: #ffffff)
You can also set `WEBHEADERART` per web, by defining the variable in the Web's WebPreferences.
If you have localization enabled, you will also see a language dropdown box at the far right.
-You can remove these items from %SYSTEMWEB%.WebTopBar.
+You can remove these items from [[WebTopBar]].
### <a name="I want to hide the top bar"></a> I want to hide the top bar
Each included template draws a part of the screen.%BR% Omit `%TMPL:INCLUDE{"viewtopbar"}%` to hide the top bar.
-Another approach is to clear the contents of module `topbar`. Using either a template or a topic template, write in your custom template:
+Another approach is to clear the contents of module `topbar` with an empty definition. Using either a template or a topic template, write in your custom template:
> %TMPL:INCLUDE{"view"}%
-> %TMPL:INCLUDE{"topbar"}%%TMPL:END%
+> %TMPL:DEF{"topbar"}%%TMPL:END%
>
> and add:
>
**Using templates:** %BR% Omit `%TMPL:INCLUDE{"viewleftbar"}%` to hide the left bar, or in a custom template clear it using
-> %TMPL:DEF{"viewleftbar"}%%TMPL:END%
+> %TMPL:DEF{"leftbar"}%%TMPL:END%
+> %TMPL:DEF{"leftbardimensions"}%%TMPL:END%
**Using style sheets:** %BR% See [[PatternSkinCssCookbookNoLeftBar]]
>
> And change the number from 12em to a different value (3 occurrences).
-## <a name="Other page parts"></a> Other page parts
+## <a name="Buttons"></a> Buttons
### <a name="I want to hide the edit buttons"></a><a name="I want to hide the edit buttons "></a> I want to hide the edit buttons from certain users
It may defy the wiki-ness of your TWiki installation, but in certain circumstances it could be useful to hide the edit buttons from users that are not logged in, for instance for clients that have gotten viewing rights only.
-Using either a template or a topic template, 'empty' `topicaction` and `toolbar` by writing:
+Using either a template or a topic template, 'empty' `top:toolbarbuttons` and `topicaction` by writing:
> %TMPL:INCLUDE{"view"}%
+> %TMPL:DEF{"top:toolbarbuttons"}%%TMPL:END%
> %TMPL:DEF{"topicaction"}%%TMPL:END%
-> %TMPL:DEF{"toolbar"}%%TMPL:END%
-In the user page of %USERSWEB%.TWikiGuest, set the cover to
+In the user page of [[TWikiGuest]], set the cover to
> * Set COVER = customer
### <a name="I want to remove the History but"></a> I want to remove the History button from the bottom
-All action buttons are defined in `viewtopicactionbuttons.pattern.tmpl`. The history buttons or in module `revisions`:
+All action links and buttons are defined in `viewtopicactionbuttons.tmpl`. The bottom history link is defined in DEF `action_revisions`
+
+> %TMPL:DEF{"topicactionbuttons"}%
+> %TMPL:P{"action_activatable_edit_or_create"}%
+> %TMPL:P{"action_activatable_attach"}%
+> %TMPL:P{"action_printable"}%
+> %TMPL:P{"action_revisions"}%
+> %TMPL:P{"action_backlinks_simple"}%
+> %TMPL:P{"action_raw_or_view"}%
+> %TMPL:P{"action_activatable_raw_edit"}%
+> %TMPL:P{"activatable_more"}%
+> %TMPL:END%
+
+To hide that link, In a custom skin view template `view.myskin.tmpl` empty `action_revisions` by replacing it with an empty string:
+
+> %TMPL:INCLUDE{"view"}%
+> %TMPL:DEF{"action_revisions"}%%TMPL:END%
-> <code> %TMPL:DEF\{"topicactionbuttons"\}%%TMPL:P\{"activatable\_raw\_edit"\}%%TMPL:P\{"sep"\}% %TMPL:P\{context="WysiwygPluginEnabled" then="activatable\_edit\_wysiwyg"\}% %TMPL:P\{context="WysiwygPluginEnabled" then="sep"\}% %TMPL:P\{"activatable\_attach"\}%%TMPL:P\{"sep"\}% %TMPL:P\{"printable"\}%%TMPL:P\{"sep"\}% %TMPL:P\{"raw"\}%%TMPL:P\{"sep"\}% %TMPL:P\{"backlinks"\}%%TMPL:P\{"sep"\}% %TMPL:P\{"revisions"\}%%TMPL:P\{"sep"\}% <span><font>< HERE</font></span> %TMPL:P\{"activatable\_more"\}%%TMPL:END% </code>
+### <a name="I want to put the bottom links a"></a> I want to put the bottom links as buttons at the top
-If we emptied module `revisions` we would end up with 2 separators, so we need to remove the line altogether. We do this by copying the block and omitting the line. %BR% Using either a template or a topic template, to remove the history buttons write in your custom template:
+The default definition in `view.pattern.tmpl` is:
+
+ %TMPL:DEF{"top:toolbarbuttons"}%%TMPL:P{"activatable_edit_or_create"}%%TMPL:P{"activatable_attach"}%%TMPL:END%
+
+Create a new skin by creating a file `view.myskin.tmpl` in the `templates` directory. Write in it:
> %TMPL:INCLUDE{"view"}%
->
-> %TMPL:DEF{"topicactionbuttons"}%%TMPL:P{"activatable_raw_edit"}%%TMPL:P{"sep"}%
-> %TMPL:P{context="WysiwygPluginEnabled" then="activatable_edit_wysiwyg"}%
-> %TMPL:P{context="WysiwygPluginEnabled" then="sep"}%
-> %TMPL:P{"activatable_attach"}%%TMPL:P{"sep"}%
-> %TMPL:P{"printable"}%%TMPL:P{"sep"}%
-> %TMPL:P{"raw"}%%TMPL:P{"sep"}%
-> %TMPL:P{"backlinks"}%%TMPL:P{"sep"}%
-> %TMPL:P{"activatable_more"}%%TMPL:END%
->
-> Remove all newlines if you copy-paste above text.
+> %TMPL:DEF{"top:toolbarbuttons"}%%TMPL:P{"history_history_link"}%%TMPL:END%
+
+View any topic with `?skin=myskin,pattern`, or set the `SKIN` variable to `myskin,pattern`.
+
+This will remove the Edit and Attach buttons, and place a History button at the top.
+
+You will probably not just want to have the History button there. Other button include names are:
+
+> create_topic_link
+> raw_edit_link
+> view_topic_link
+> activatable_attach
+> activatable_edit_or_create
+> more_link
+> activatable_printable
+> backlinks_web_link
+> backlinks_all_link
+> backlinks_link
+> history_rdiff_link
+> history_history_link
+> raw_link
+
+## <a name="Other page parts"></a> Other page parts
### <a name="I want to insert text outside of"></a> I want to insert text outside of the topic content
-PatternSkin has 2 'buckets' to write additional content to: `beforetextcontents` and `aftertextcontents`, both defined in `view.pattern.tmpl`. These containers can contain text or html and are placed directly before and after the topic text.
+PatternSkin has 2 'buckets' to write additional content to: `contentheader` and `contentfooter`, both defined in `view.pattern.tmpl`. These containers can contain text or html and are placed directly before and after the topic text.
Both modules are wrapped in CSS containers:
-- `beforetextcontents` - wrapped in `div` of class `twikiBeforeText`
-- `aftertextcontents` - wrapped in `div` of class `twikiAfterText`
+- `contentheader` - wrapped in `div` of class `twikiContentHeader`
+- `contentfooter` - wrapped in `div` of class `twikiContentFooter`
To put contents **before** the main text, use the custom skin approach as described above.%BR% So our custom template contains:
> %TMPL:INCLUDE{"view"}%
-> %TMPL:DEF{"beforetextcontents"}%This is the text before%TMPL:END%
+> %TMPL:DEF{"contentheader"}%This is the text before%TMPL:END%
Use the same procedure for contents to be put **after** the topic text:
> %TMPL:INCLUDE{"view"}%
-> %TMPL:DEF{"aftertextcontents"}%This is the text after%TMPL:END%
+> %TMPL:DEF{"contentfooter"}%This is the text after%TMPL:END%
### <a name="I want to place the form at the"></a><a name="I want to place the form at the "></a> I want to place the form at the top
-Pattern skin has 2 buckets for the form: `formattop` (form-at-the-top) and `formatbottom` (form-at-the-bottom):
+Pattern skin has 2 buckets for the form: `formtop` (form at the top) and `formbottom` (form at the bottom). The default definition is:
-> %TMPL:DEF{"formattop"}%%TMPL:END%
-> %TMPL:DEF{"formatbottom"}%%TMPL:P{"form"}%%TMPL:END%
+> %TMPL:DEF{"formtop"}%%TMPL:END%
+> %TMPL:DEF{"formbottom"}%%TMPL:P{"form"}%%TMPL:END%
You simply swap the bucket contents. Using either a template or a topic template, write in your custom template:
> %TMPL:INCLUDE{"view"}%
-> %TMPL:DEF{"formattop"}%%TMPL:P{"form"}%%TMPL:END%
-> %TMPL:DEF{"formatbottom"}%%TMPL:END%
+> %TMPL:DEF{"formtop"}%%TMPL:P{"form"}%%TMPL:END%
+> %TMPL:DEF{"formbottom"}%%TMPL:END%
+
+### <a name="I want to put the topic form in"></a><a name="I want to put the topic form in "></a> I want to put the topic form in a twisty
+
+The attachment tables are placed in a open/close twisty. You can do the same for the topic form.
+
+Edit `templates/formtables.pattern.tmpl` to have this code:
+
+ %{ These templates define the form attached at the bottom of viewed page. }%
+
+ %TMPL:DEF{"starttopicformwisty"}%%TWISTY{id="topicformlist" mode="div" remember="on" link="%MAKETEXT{"Form"}%" showimgleft="%ICONURLPATH{toggleopen}%" hideimgleft="%ICONURLPATH{toggleclose}%"}%%TMPL:END%
+
+ %TMPL:DEF{"endtopicformwisty"}%%ENDTWISTY%%TMPL:END%
+
+ %{ Start of form table }%
+ %TMPL:DEF{FORM:display:header}%<div class="twikiForm">%TMPL:P{"starttopicformwisty"}%
+ <table class='twikiFormTable' border='1'>%TMPL:P{FORM:display:header:headerrow}%%TMPL:END%
-### <a name="I only want to show the WYSIWYG"></a><a name="I only want to show the WYSIWYG "></a> I only want to show the WYSIWYG button on explicit pages
+ %{ Header }%
+ %TMPL:DEF{FORM:display:header:headerrow}%<tr><th class='twikiFormTableHRow twikiFirstCol' colspan='2'>
+ [[%A_TITLE%]]
+ </th></tr>%TMPL:END%
-In [[Main.TWikiPreferences|Main/TWikiPreferences]], set `COMPOSER` to a blank value:
+ %{ Each row }%
+ %TMPL:DEF{FORM:display:row}%<tr valign='top'><td class='twikiFormTableRow twikiFirstCol' align='right'> %A_TITLE% </td><td>
+ %A_VALUE%
+ </td></tr>%TMPL:END%
-> * Set COMPOSER =
+ %{ Footer }%
+ %TMPL:DEF{FORM:display:footer}%</table>%TMPL:P{FORM:display:footer:editlink}%
+ %TMPL:P{"endtopicformwisty"}%</div><!-- /twikiForm -->%TMPL:END%
-In the topic, set the `COMPOSER` variable to `kupu`:
+To give the twisty toggle link the same style as the attachment twisty link, add this to pattern skin's `style.css`:
-> * Set COMPOSER = kupu
+ .twikiForm .twistyTrigger .twikiLinkLabel {
+ font-size:122%; /* h4 size */
+ font-weight:bold;
+ }
</tr>
<tr>
<td align="right"> Plugin Version: </td>
- <td> 15487 (04 Aug 2008) </td>
+ <td> 15487 (06 Dec 2008) </td>
</tr>
<tr>
<td align="right"> Change History: </td>
<table border="1" cellpadding="0" cellspacing="0">
<tr>
- <td colspan="4"> You can use color coding by web for identification and reference. This table is updated automatically based on WebPreferences settings of the individual webs. Contact if you need a separate collaboration web for your team. See also [[Main/AdminToolsCategory]]. </td>
+ <td colspan="4"> You can use color coding by web for identification and reference. This table is updated automatically based on WebPreferences settings of the individual webs. Contact if you need a separate collaboration web for your team. See also %SYSTEMWEB%.AdminToolsCategory. </td>
</tr>
</table>
<li><a href="#TWiki::_I18N"> TWiki::I18N </a></li>
<li><a href="#TWiki::_I18N::Extract"> TWiki::I18N::Extract </a></li>
<li><a href="#TWiki::If::Node"> TWiki::If::Node </a></li>
+ <li><a href="#TWiki::If::OP_isweb"> TWiki::If::OP_isweb </a></li>
<li><a href="#TWiki::If::Parser"> TWiki::If::Parser </a></li>
<li><a href="#TWiki::Infix::Error"> TWiki::Infix::Error </a></li>
<li><a href="#TWiki::Infix::Node"> TWiki::Infix::Node </a></li>
## <> \[[TWikiConfigureUIsEXTENDDotPm]\[]]
-This package has smell factor of **1**
+This package has smell factor of **2**
## <a name="TWiki"></a> [[TWiki|Main/TWikiDotPm]]
- `users` TWiki::Users singleton
- `webName` Name of web found in URL path, or `web` URL parameter, or \{UsersWebName\}
-This package has smell factor of **34**
+This package has smell factor of **35**
## <a name="TWiki::Form"></a> [[TWiki::Form|Main/TWikiFormDotPm]]
This package doesn't smell
+## <a name="TWiki::If::OP_isweb"></a> [[TWiki::If::OP_isweb|Main/TWikiIfOP_iswebDotPm]]
+
+This package doesn't smell
+
## <a name="TWiki::If::Parser"></a> [[TWiki::If::Parser|Main/TWikiIfParserDotPm]]
Support for the conditions in %IF\{\} statements.
This module provides most of the actual HTML rendering code in TWiki.
- This package has smell factor of *20*
+ This package has smell factor of *22*
---++ [[TWikiSandboxDotPm][TWiki::Sandbox]]
User registration handling.
- This package has smell factor of *5*
+ This package has smell factor of *8*
---++ [[TWikiUISaveDotPm][TWiki::UI::Save]]
This package doesn't smell
- There were a total of *193* smells
+ There were a total of *200* smells
</tr>
<tr>
<td> .twikiSubmit </td>
- <td> </td>
+ <td> Submit button </td>
</tr>
<tr>
<td> .twikiSubmitDisabled </td>
- <td> </td>
+ <td> Disabled submit button </td>
</tr>
<tr>
<td> .twikiInputField </td>
<td> for use with Javascript: the color of the input text when not clicked in the field </td>
</tr>
<tr>
+ <td> .twikiSelect </td>
+ <td> Select dropdown menu </td>
+ </tr>
+ <tr>
<td> .twikiTextarea </td>
<td> </td>
</tr>
<td> .twikiPopUp </td>
<td> Behaviour marker so a popup-window can be invoked </td>
</tr>
+ <tr>
+ <td> .twikiContentHeader </td>
+ <td> container around optional html placed before topic text </td>
+ </tr>
+ <tr>
+ <td> .twikiContentFooter </td>
+ <td> container around optional html placed after topic text </td>
+ </tr>
</table>
### <a name="TWiki Styles used in <code>configure="></a> TWiki Styles used in =configure
<td bgcolor="#ffffff" style=""><code>%ICON{target}%</code></td>
</tr>
<tr>
+ <td bgcolor="#ffffff" style=""><img alt="Target - blue" src="http://www.dementia.org/twiki//view/target-blue.gif" title="Target - blue" /></td>
+ <td bgcolor="#ffffff" style=""><code>target-blue.gif</code></td>
+ <td bgcolor="#ffffff" style=""> Target - blue </td>
+ <td bgcolor="#ffffff" style=""><code>%ICON{target-blue}%</code></td>
+ </tr>
+ <tr>
+ <td bgcolor="#ffffff" style=""><img alt="Target - gray" src="http://www.dementia.org/twiki//view/target-gray.gif" title="Target - gray" /></td>
+ <td bgcolor="#ffffff" style=""><code>target-gray.gif</code></td>
+ <td bgcolor="#ffffff" style=""> Target - gray </td>
+ <td bgcolor="#ffffff" style=""><code>%ICON{target-gray}%</code></td>
+ </tr>
+ <tr>
+ <td bgcolor="#ffffff" style=""><img alt="Target - green" src="http://www.dementia.org/twiki//view/target-green.gif" title="Target - green" /></td>
+ <td bgcolor="#ffffff" style=""><code>target-green.gif</code></td>
+ <td bgcolor="#ffffff" style=""> Target - green </td>
+ <td bgcolor="#ffffff" style=""><code>%ICON{target-green}%</code></td>
+ </tr>
+ <tr>
+ <td bgcolor="#ffffff" style=""><img alt="Target - orange" src="http://www.dementia.org/twiki//view/target-orange.gif" title="Target - orange" /></td>
+ <td bgcolor="#ffffff" style=""><code>target-orange.gif</code></td>
+ <td bgcolor="#ffffff" style=""> Target - orange </td>
+ <td bgcolor="#ffffff" style=""><code>%ICON{target-orange}%</code></td>
+ </tr>
+ <tr>
+ <td bgcolor="#ffffff" style=""><img alt="Target - red" src="http://www.dementia.org/twiki//view/target-red.gif" title="Target - red" /></td>
+ <td bgcolor="#ffffff" style=""><code>target-red.gif</code></td>
+ <td bgcolor="#ffffff" style=""> Target - red </td>
+ <td bgcolor="#ffffff" style=""><code>%ICON{target-red}%</code></td>
+ </tr>
+ <tr>
<td bgcolor="#ffffff" style=""><img alt="Tip, idea" src="http://www.dementia.org/twiki//view/tip.gif" title="Tip, idea" /></td>
<td bgcolor="#ffffff" style=""><code>tip.gif</code></td>
<td bgcolor="#ffffff" style=""> Tip, idea </td>
Get a hash of context identifiers representing the currently active context.
-The context is a set of identifiers that are set during specific phases of TWiki processing. For example, each of the standard scripts in the 'bin' directory each has a context identifier - the view script has 'view', the edit script has 'edit' etc. So you can easily tell what 'type' of script your Plugin is being called within. The core context identifiers are listed in the %SYSTEMWEB%.TWikiTemplates topic. Please be careful not to overwrite any of these identifiers!
+The context is a set of identifiers that are set during specific phases of TWiki processing. For example, each of the standard scripts in the 'bin' directory each has a context identifier - the view script has 'view', the edit script has 'edit' etc. So you can easily tell what 'type' of script your Plugin is being called within. The core context identifiers are listed in the %SYSTEMWEB%.IfStatements topic. Please be careful not to overwrite any of these identifiers!
Context identifiers can be used to communicate between Plugins, and between Plugins and templates. For example, in [[FirstPlugin]].pm, you might write:
<div>
<ul>
<li><a href="#Appendix A: TWiki Development Ti"> Appendix A: TWiki Development Time-line</a><ul>
- <li><a href="#TWiki Release 4.2.1 (Freetown) r"> TWiki Release 4.2.1 (Freetown) released 00:13:28 04 August 2008</a></li>
+ <li><a href="#TWiki Release 4.2.4 (Georgeown)"> TWiki Release 4.2.4 (Georgeown) released 00:35:32 06 December 2008</a></li>
<li><a href="#TWiki Release 4.1 (Edinburgh), 1"> TWiki Release 4.1 (Edinburgh), 16 Jan 2007</a></li>
<li><a href="#TWiki Release 4.0.0 (Dakar), 01"> TWiki Release 4.0.0 (Dakar), 01 Feb 2006</a></li>
<li><a href="#01-Sep-2004 Release (Cairo)"> 01-Sep-2004 Release (Cairo)</a></li>
<a name="FreetownRelease"></a>
-## <a name="TWiki Release 4.2.1 (Freetown) r"></a> TWiki Release 4.2.1 (Freetown) released 00:13:28 04 August 2008
+## <a name="TWiki Release 4.2.4 (Georgeown)"></a><a name="TWiki Release 4.2.4 (Georgeown) "></a> TWiki Release 4.2.4 (Georgeown) released 00:35:32 06 December 2008
Patch release following the 4.2.0 released 22 Jan 2008
Many people have been involved in creating TWiki 4.2. Special thanks go to the most active contributors in the following areas:
- Release management led by TWiki:Main.KennethLavrsen, ably assisted by TWiki:Main.SvenDowideit
-- Design and development driven by TWiki:Main.CrawfordCurrie, TWiki:Main.ArthurClemens, [[KennethLavrsen]] and TWiki:Main.SvenDowideit
+- Design and development driven by TWiki:Main.CrawfordCurrie, TWiki:Main.ArthurClemens, TWiki:Main.KennethLavrsen and TWiki:Main.SvenDowideit
- Testing driven by TWiki:Main.KennethLavrsen
Many thanks also to the contributors in the following areas:
--- /dev/null
+# <a name="Package <code>TWiki::If::OP_isweb="></a> Package =TWiki::If::OP\_isweb
+
+<div>
+ <ul>
+ <li><a href="#Package =TWiki::If::OP_isweb="> Package TWiki::If::OP_isweb</a></li>
+ </ul>
+</div>
<ul>
<li><a href="#Package =TWiki::Infix::Parser="> Package TWiki::Infix::Parser</a><ul>
<li><a href="#new($client_class, \%options) ->"> new($client_class, \%options) -> parser object</a></li>
- <li><a href="#ObjectMethod <strong>addOperator</strong> (%ope"> ObjectMethod addOperator <tt>(%oper)</tt></a></li>
+ <li><a href="#ObjectMethod <strong>addOperator</strong> (\%op"> ObjectMethod addOperator <tt>(\%oper)</tt></a></li>
<li><a href="#ObjectMethod <strong>parse</strong> ($string) -"> ObjectMethod parse <tt>($string) -> $parseTree</tt></a></li>
</ul>
</li>
1. `words=>qr//` - should be an RE specifying legal words (unquoted terminals that are not operators i.e. names and numbers). By default this is `\w+`. It's ok if operator names match this RE; operators always have precedence over atoms.
2. `numbers=>qr//` - should be an RE specifying legal numbers (unquoted terminals that are not operators or words). By default this is `qr/[+-]?(?:\d+\.\d+|\d+\.|\.\d+|\d+)(?:[eE][+-]?\d+)?/`, which matches integers and floating-point numbers. Number matching always takes precedence over word matching (i.e. "1xy" will be parsed as a number followed by a word. A typical usage of this option is when you only want to recognise integers, in which case you would set this to `numbers => qr/\d+/`.
-## <a name="ObjectMethod <strong>addOperator</strong> (%ope"></a> [[ObjectMethod]] **addOperator** `(%oper)`
+## <a name="ObjectMethod <strong>addOperator</strong> (\%op"></a> [[ObjectMethod]] **addOperator** `(\%oper)`
Add an operator to the parser.
-`%oper` is a hash, containing the following fields:
+`\%oper` is a hash (or an object), containing the following fields:
- `name` - operator string
- `prec` - operator precedence, positive non-zero integer. Larger number => higher precedence.
These are the steps for enabling "Template Login" which asks for a username and password in a web page, and processes them using the Apache 'htpasswd' password manager. Users can log in and log out.
1. Under the `Security Settings` pane of `configure` :
- 1. Select `TWiki::Client::TemplateLogin` for `{LoginManager}`.
+ 1. Select `TWiki::LoginManager::TemplateLogin` for `{LoginManager}`.
2. Select `TWiki::Users::HtPasswdUser` for `{PasswordManager}`.
3. Save your `configure` settings.
4. Register yourself using the `TWiki.TWikiRegistration` topic.<br /> %H% Check that the password manager recognizes the new user. Check that a new line with the username and encrypted password is added to the `data/.htpasswd` file. If not, you probably got a path wrong, or the permissions may not allow the webserver user to write to that file.
You are strongly encouraged to read `TWiki.TWikiUserAuthentication`, TWiki:TWiki.TWikiUserAuthenticationSupplement, and TWiki:TWiki.SecuringTWikiSite for further information about managing users and security of your TWiki site.
-**Note!** The other `LoginManager` option `TWiki::Client::ApacheLogin` uses a basic Apache type authentication where the browser itself prompts you for username and password. Most will find the TemplateLogin looking nicer. But ApacheLogin is required when you use Apache authentication methods like mod\_ldap where all authentication is handled by an Apache module and not by the TWiki perl code. When you use ApacheLogin the apache configuration must be set up to require authentication of the some but not all the scripts in the bin directory. This section in the Apache config (or .htaccess) controls this
+**Note!** The other `LoginManager` option `TWiki::LoginManager::ApacheLogin` uses a basic Apache type authentication where the browser itself prompts you for username and password. Most will find the TemplateLogin looking nicer. But ApacheLogin is required when you use Apache authentication methods like mod\_ldap where all authentication is handled by an Apache module and not by the TWiki perl code. When you use ApacheLogin the apache configuration must be set up to require authentication of the some but not all the scripts in the bin directory. This section in the Apache config (or .htaccess) controls this
<FilesMatch "(attach|edit|manage|rename|save|upload|mail|logon|rest|.*auth).*">
require valid-user
-# <a name="TWiki Release 4.1.2 (Edinburgh),"></a><a name=" TWiki Release 4.1.2 (Edinburgh)"></a> TWiki Release 4.1.2 (Edinburgh), 00:13:28 04 August 2008
+# <a name="TWiki Release 4.1.2 (Edinburgh),"></a><a name=" TWiki Release 4.1.2 (Edinburgh)"></a> TWiki Release 4.1.2 (Edinburgh), 00:35:32 06 December 2008
_Note: This is the release note for the previous major release version 4.1.X. This note and the [[TWikiReleaseNotes04x00]] are included with 4.2.X because they contain valuable information for people upgrading from earlier versions. Both for the admin and the users. See [[TWikiReleaseNotes04x02]] for the 4.2.X release notes_
## <a name="TWiki 4.1.2 Patch Release Detail"></a> TWiki 4.1.2 Patch Release Details
-The 4.1.2 release was built from SVN <http://svn.twiki.org/svn/twiki/Patch04x01> revision 17311 (04 Aug 2008) (00:13:28 04 August 2008).
+The 4.1.2 release was built from SVN <http://svn.twiki.org/svn/twiki/Patch04x01> revision 17773 (06 Dec 2008) (00:35:32 06 December 2008).
TWiki 4.1.1 Fixes
-# <a name="TWiki Release 4.2.1 (Freetown),"></a><a name=" TWiki Release 4.2.1 (Freetown),"></a> TWiki Release 4.2.1 (Freetown), 00:13:28 04 August 2008
+# <a name="TWiki Release 4.2.4 (Georgetown)"></a><a name=" TWiki Release 4.2.4 (Georgetown"></a> TWiki Release 4.2.4 (Georgetown), 00:35:32 06 December 2008
<div>
<ul>
<li><a href="#Introduction"> Introduction</a></li>
<li><a href="#Pre-installed Extensions"> Pre-installed Extensions</a></li>
<li><a href="#New Features Highlights"> New Features Highlights</a></li>
+ <li><a href="#Important Changes since 4.2.4"> Important Changes since 4.2.4 </a></li>
+ <li><a href="#Important Changes since 4.2.3"> Important Changes since 4.2.3</a></li>
+ <li><a href="#Important Changes since 4.2.2"> Important Changes since 4.2.2</a></li>
+ <li><a href="#Important Changes since 4.2.1"> Important Changes since 4.2.1</a><ul>
+ <li><a href="#Highlights of bug fixes since 4."> Highlights of bug fixes since 4.2.1</a></li>
+ </ul>
+ </li>
<li><a href="#Important Changes since 4.2.0"> Important Changes since 4.2.0</a><ul>
<li><a href="#Perl 5.8 is now minimum requirem"> Perl 5.8 is now minimum requirement with Wysiwyg</a></li>
<li><a href="#TWiki now installs and works wit"> TWiki now installs and works with Perl 5.10.0.</a></li>
</li>
<li><a href="#API Enhancements (Func)"> API Enhancements (Func)</a></li>
<li><a href="#Deprecation Notices"> Deprecation Notices</a></li>
- <li><a href="#TWiki 4.2.0 Minor Release - Deta"> TWiki 4.2.0 Minor Release - Details</a></li>
- <li><a href="#Fixes"> Fixes</a></li>
- <li><a href="#Enhancements"> Enhancements</a></li>
- <li><a href="#TWiki 4.2.1 Minor Release - Deta"> TWiki 4.2.1 Minor Release - Details</a></li>
- <li><a href="#Fixes"> Fixes</a></li>
- <li><a href="#Enhancements"> Enhancements</a></li>
+ <li><a href="#TWiki 4.2.0 Minor Release - Deta"> TWiki 4.2.0 Minor Release - Details</a><ul>
+ <li><a href="#Fixes"> Fixes</a></li>
+ <li><a href="#Enhancements"> Enhancements</a></li>
+ </ul>
+ </li>
+ <li><a href="#TWiki 4.2.1 Patch Release - Deta"> TWiki 4.2.1 Patch Release - Details</a><ul>
+ <li><a href="#Fixes"> Fixes</a></li>
+ <li><a href="#Enhancements"> Enhancements</a></li>
+ </ul>
+ </li>
+ <li><a href="#TWiki 4.2.2 Patch Release - Deta"> TWiki 4.2.2 Patch Release - Details</a><ul>
+ <li><a href="#Fixes"> Fixes</a></li>
+ <li><a href="#Enhancements"> Enhancements</a></li>
+ </ul>
+ </li>
+ <li><a href="#TWiki 4.2.3 Patch Release - Deta"> TWiki 4.2.3 Patch Release - Details</a><ul>
+ <li><a href="#Fixes"> Fixes</a></li>
+ <li><a href="#Enhancements"> Enhancements</a></li>
+ </ul>
+ </li>
+ <li><a href="#TWiki 4.2.4 Patch Release - Deta"> TWiki 4.2.4 Patch Release - Details</a><ul>
+ <li><a href="#Fixes"> Fixes</a></li>
+ <li><a href="#Enhancements"> Enhancements</a></li>
+ </ul>
+ </li>
</ul>
</div>
TWiki 4.2.0 was released 22 Jan 2008 and introduced some hot new features that make TWiki a better user experience for both beginners and experienced application developers. It also contained quite a number of bugfixes since 4.1.2.
-TWiki 4.2.1 is a patch release which only contains bug fixes. More than 150 bugs have been fixed since the release of 4.2.1 in all areas of TWiki.
+TWiki 4.2.1 is a patch release which only contains bug fixes. More than 150 bugs have been fixed since the release of 4.2.0 in all areas of TWiki.
+
+TWiki 4.2.2 is a patch release which only contains bug fixes. The major issues fixed since the release of 4.2.1 in all areas of TWiki are the registration verification code validation, and web specified `REVINFO` usage.
+
+TWiki 4.2.3 is a patch release containing only the configure script as a security fix for TWiki:Codev.SecurityAlert-CVE-2008-3195.
-It is highly recommended to upgrade TWiki 4.2.0 to 4.2.1. Users will find the 4.2.1 much more stable in daily use.
+TWiki 4.2.4 is a patch release which only contains over 30 bug fixes. This release also has a security fix for TWiki:Codev.SecurityAlert-CVE-2008-5304 and TWiki:Codev.SecurityAlert-CVE-2008-5305
+
+It is highly recommended to upgrade TWiki 4.2.x to 4.2.4. Users will find the 4.2.4 much more stable in daily use.
## <a name="Pre-installed Extensions"></a> Pre-installed Extensions
-TWiki 4.2.1 is shipped with
+TWiki 4.2.4 is shipped with
- **Plugins:** CommentPlugin, EditTablePlugin, EmptyPlugin, InterwikiPlugin, PreferencesPlugin, RenderListPlugin, SlideShowPlugin, SmiliesPlugin, SpreadSheetPlugin, TablePlugin, TinyMCEPlugin, TwistyPlugin, WysiwygPlugin
- **Contribs:** BehaviourContrib, JSCalendarContrib, MailerContrib, TipsContrib, TWikiUserMappingContrib, TwistyContrib
- Table of Content (TOC) feature enhanced
- User Mapping (mapping between login name and WikiName) code has been extended to allow pluggable modules to integrate with all sorts of alternative authentication and Management schemes. For normal cases you use the default TWikiUserMapping which is using the Main.TWikiUsers topic to map between login and WikiName. A new BaseUserMapping is provided for TWikis where you only have guests and an administrator. In this case you use the login and password given in configure to login as an admin.
+## <a name="Important Changes since 4.2.4"></a> Important Changes since 4.2.4
+
+This release was targeted for fixing maximum number of bugs. We have also fixed security issues listed at TWiki:Codev.SecurityAlert-CVE-2008-5304 and TWiki:Codev.SecurityAlert-CVE-2008-5305
+
+## <a name="Important Changes since 4.2.3"></a> Important Changes since 4.2.3
+
+This release was targeted to fix the configure script as described security issue in TWiki:Codev.SecurityAlert-CVE-2008-3195.
+
+## <a name="Important Changes since 4.2.2"></a> Important Changes since 4.2.2
+
+TWiki 4.2.3 is a patch release containing only the configure script as a security fix for TWiki:Codev.SecurityAlert-CVE-2008-3195.
+
+## <a name="Important Changes since 4.2.1"></a> Important Changes since 4.2.1
+
+This is a fast trip bug fix for issues found during upgrades from 4.2.0 to 4.2.1.
+
+### <a name="Highlights of bug fixes since 4."></a> Highlights of bug fixes since 4.2.1
+
+- Registration with verification fails in 4.2.1
+- `REVINFO` with web specified in topic param renders as though topic does not exist.
+- TWiki::Compatibility has undefined variable error
+
+See the full list of bug fixes at the bottom of this topic.
+
## <a name="Important Changes since 4.2.0"></a> Important Changes since 4.2.0
### <a name="Perl 5.8 is now minimum requirem"></a> Perl 5.8 is now minimum requirement with Wysiwyg
## <a name="TWiki 4.2.0 Minor Release - Deta"></a> TWiki 4.2.0 Minor Release - Details
-The 4.2.0 release was built from SVN <http://svn.twiki.org/svn/twiki/branches/TWikiRelease04x02> revision 17311 (04 Aug 2008).
+The 4.2.0 release was built from SVN <http://svn.twiki.org/svn/twiki/branches/TWikiRelease04x02> revision 16277 (22 Jan 2008)
-## <a name="Fixes"></a> Fixes
+### <a name="Fixes"></a> Fixes
<table border="1" cellpadding="0" cellspacing="0">
<tr>
</tr>
<tr>
<td>[[BUGS/Item3803]]</td>
- <td> %!USERINFO{format="$groups"}% crashes </td>
+ <td> %USERINFO{format="$groups"}% crashes </td>
</tr>
<tr>
<td>[[BUGS/Item3796]]</td>
</tr>
<tr>
<td>[[BUGS/Item3703]]</td>
- <td> & nbsp; in the size field of a form will crash the forms code </td>
+ <td> &nbsp; in the size field of a form will crash the forms code </td>
</tr>
<tr>
<td>[[BUGS/Item3690]]</td>
</tr>
<tr>
<td>[[BUGS/Item3689]]</td>
- <td> CommentPlugin location only works if it is above the %COMMENT... tag </td>
+ <td> CommentPlugin location only works if it is above the %COMMENT... variable </td>
</tr>
<tr>
<td>[[BUGS/Item3688]]</td>
</tr>
<tr>
<td>[[BUGS/Item2772]]</td>
- <td> Mailto link should use %20 instead of for spaces </td>
+ <td> Mailto link should use %20 instead of &#32; for spaces </td>
</tr>
<tr>
<td>[[BUGS/Item2690]]</td>
</tr>
</table>
-## <a name="Enhancements"></a> Enhancements
+### <a name="Enhancements"></a> Enhancements
<table border="1" cellpadding="0" cellspacing="0">
<tr>
</tr>
</table>
-## <a name="TWiki 4.2.1 Minor Release - Deta"></a> TWiki 4.2.1 Minor Release - Details
+## <a name="TWiki 4.2.1 Patch Release - Deta"></a> TWiki 4.2.1 Patch Release - Details
-The 4.2.1 release was built from SVN <http://svn.twiki.org/svn/twiki/branches/TWikiRelease04x02> revision 17311 (04 Aug 2008).
+The 4.2.1 release was built from SVN <http://svn.twiki.org/svn/twiki/branches/TWikiRelease04x02> revision 17311 (03 Aug 2008)
-## <a name="Fixes"></a> Fixes
+### <a name="Fixes"></a> Fixes
<table border="1" cellpadding="0" cellspacing="0">
<tr>
</tr>
</table>
-## <a name="Enhancements"></a> Enhancements
+### <a name="Enhancements"></a> Enhancements
None!
+## <a name="TWiki 4.2.2 Patch Release - Deta"></a> TWiki 4.2.2 Patch Release - Details
+
+The 4.2.2 release was built from SVN <http://svn.twiki.org/svn/twiki/branches/TWikiRelease04x02> revision 17396 (10 Aug 2008).
+
+### <a name="Fixes"></a> Fixes
+
+<table border="1" cellpadding="0" cellspacing="0">
+ <tr>
+ <td>[[BUGS/Item5892]]</td>
+ <td> Registration with verification fails in 4.2.1 </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5884]]</td>
+ <td> REVINFO{"$rev" topic="Bugs.ReleaseNotesTml"} seems to be returning '0' </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5880]]</td>
+ <td> TablePlugin may delete query parameters after reordering some table </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5898]]</td>
+ <td> prevent the browser from saving passwords in template login </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5888]]</td>
+ <td> simple refactoring to expand the possibility of more advanced SEARCH implementations. </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5887]]</td>
+ <td> TWiki Compatibility has an undefined variariable error </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5904]]</td>
+ <td> Translation bug in the german translation in TWiki 4.2.1 </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5907]]</td>
+ <td> fix author for topics in release </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5906]]</td>
+ <td> VarEDITACTION topic was missing from MANIFEST </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item4683]]</td>
+ <td> that putting the word CGI into ==='s makes it dissapear. </td>
+ </tr>
+</table>
+
+### <a name="Enhancements"></a> Enhancements
+
+None!
+
+## <a name="TWiki 4.2.3 Patch Release - Deta"></a> TWiki 4.2.3 Patch Release - Details
+
+### <a name="Fixes"></a> Fixes
+
+Only security issue from "configure" script as described in TWiki:Codev.SecurityAlert-CVE-2008-3195. was fixed in this release.
+
+### <a name="Enhancements"></a> Enhancements
+
+None!
+
+## <a name="TWiki 4.2.4 Patch Release - Deta"></a> TWiki 4.2.4 Patch Release - Details
+
+### <a name="Fixes"></a> Fixes
+
+<table border="1" cellpadding="0" cellspacing="0">
+ <tr>
+ <td>[[BUGS/Item5967]]</td>
+ <td> viewfile partly broken </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item6136]]</td>
+ <td> User input is passed to the perl "eval" command without first being sanitized. </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5937]]</td>
+ <td> move initialization of SwitchBoard to TWiki.spec </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item6089]]</td>
+ <td> backslash at end of line inside verbatim and pre being used as line continuation </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item6135]]</td>
+ <td> changes required in TWikiUserMappings.pm required to support registration in case PasswordManager is LdapUser </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5961]]</td>
+ <td> WysiwygPlugin and TWiki's odd idea of needing a space before *'s causes user surprise. </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5865]]</td>
+ <td> TablePlugin should support rowspan from header row </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item6082]]</td>
+ <td> deep recursion bug in query search </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5979]]</td>
+ <td> add non-alarmist PerlOnRedHatIsSlow detection to configure </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item6005]]</td>
+ <td> EditTable changes "label"-formatted cell in unexpected way </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item6061]]</td>
+ <td> TWiki::Func::getContext documentation </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5939]]</td>
+ <td> Rogue <p /> below </html> on every topic in every web </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item6108]]</td>
+ <td> Add documentation for customising the registration emails </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item6054]]</td>
+ <td> No longer possible to have a twisty on one line without linebreak </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5176]]</td>
+ <td> %SCRIPTSUFFIX is added twice in TOC links </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item6060]]</td>
+ <td> configure's get more extensions seems to require LWP </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item6043]]</td>
+ <td> TWiki::Sandbox::sysCommand leads to errors with Plugins.FastCGIEngineContrib </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5991]]</td>
+ <td> JSCalendarContrib does not work correctly in IE7 </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item6026]]</td>
+ <td> With header format emtpy table is initialized with one column only </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item6050]]</td>
+ <td> statistics script fails when cuid is not equal login name (as login is whats in the log files...) </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item6095]]</td>
+ <td> Registration confirmation page fails to display when user confirmation e-mail can't be sent </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5914]]</td>
+ <td> TWiki::Request::url() must support -rewrite, -absolute and -relative </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5852]]</td>
+ <td> Split out operators into seperate modules, so that extensions can plug in new operators </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5994]]</td>
+ <td> Turn on taint mode in configure and fix the problems </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5943]]</td>
+ <td> TWikiRegistrationAgent should be in Main's ALLOWWEBCHANGE by default </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item6031]]</td>
+ <td> TablePlugin date sorting is broken. </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item2525]]</td>
+ <td> TablePlugin produces bad links for sorting when using "short" URLs </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5957]]</td>
+ <td> htdigest format password file gets stomped on password or email change/reset </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item6066]]</td>
+ <td> MailerContrib makes an assumption that cuid equal loginname </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5910]]</td>
+ <td> %TOC% variable creates links with unecessary query string </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item5922]]</td>
+ <td> $formfield data not being displayed in formatted searches </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item6022]]</td>
+ <td> %ENCODE{}% treats % as safe character </td>
+ </tr>
+ <tr>
+ <td>[[BUGS/Item6062]]</td>
+ <td> EditTablePlugin destroys verbatim-tags </td>
+ </tr>
+</table>
+
+### <a name="Enhancements"></a> Enhancements
+
+<table border="1" cellpadding="0" cellspacing="0">
+ <tr>
+ <td>[[BUGS/Item4875]]</td>
+ <td> Add javascript function 'makeSafeForTableEntry' </td>
+ </tr>
+</table>
+
**_Related Topic:_** [[TWikiHistory]]
<li><a href="#ObjectMethod <strong>renderParent</strong> ($we"> ObjectMethod renderParent <tt>($web,$topic,$meta,$params) -> $text</tt></a></li>
<li><a href="#ObjectMethod <strong>renderMoved</strong> ($web"> ObjectMethod renderMoved <tt>($web,$topic,$meta,$params) -> $text</tt></a></li>
<li><a href="#ObjectMethod <strong>make_AnchorName</strong> ("> ObjectMethod makeAnchorName <tt>($anchorName,$compatibilityMode) -> $anchorName</tt></a></li>
+ <li><a href="#ObjectMethod *make_UniqueAnchorN"> ObjectMethod makeUniqueAnchorName <tt>($web,$topic,$anchorName,$compatibility) -> $anchorName</tt></a></li>
<li><a href="#ObjectMethod <strong>internalLink</strong> ($th"> ObjectMethod internalLink <tt>($theWeb,$theTopic,$theLinkText,$theAnchor,$doLink,$doKeepWeb,$hasExplicitLinkLabel) -> $html</tt></a></li>
<li><a href="#ObjectMethod <strong>renderFORMFIELD</strong> ("> ObjectMethod renderFORMFIELD <tt>(%params,$topic,$web) -> $html</tt></a></li>
<li><a href="#ObjectMethod *get_RenderedVersio"> ObjectMethod getRenderedVersion <tt>($text,$theWeb,$theTopic) -> $html</tt></a></li>
Build a valid HTML anchor name
+## <a name="ObjectMethod <strong>make_UniqueAnchorN"></a> [[ObjectMethod]] \*makeUniqueAnchorName `($web,$topic,$anchorName,$compatibility) -> $anchorName`
+
+- `$anchorName` - the unprocessed anchor name
+- `$compatibilityMode` - SMELL: compatibility with **what**?? Who knows. :-(
+
+Build a valid HTML anchor name (unique w.r.t. the list stored in %anchornames)
+
## <a name="ObjectMethod <strong>internalLink</strong> ($th"></a> [[ObjectMethod]] **internalLink** `($theWeb,$theTopic,$theLinkText,$theAnchor,$doLink,$doKeepWeb,$hasExplicitLinkLabel) -> $html`
Generate a link.
</tr>
<tr>
<td><code>topic</code></td>
- <td> If defined as the full name (including web) of a topic, then when the script starts up plugins will be passed this as the "current" topic. If not defined, then %USERWEB%.WebHome will be passed to plugins. </td>
+ <td> If defined as the full name (including web) of a topic, then when the script starts up plugins will be passed this as the "current" topic. If not defined, then [[USERSWEB/WebHome]] will be passed to plugins. </td>
</tr>
<tr>
<td><code>endPoint</code></td>
- `$web` - Web name, optional, e.g. `'Main'`
- `$topic` - Topic name, required, e.g. `'TokyoOffice'`, or `"Main.TokyoOffice"`
+Warning: topicExists does not call ( $web, $topic ) = $this->\{session\}->normalizeWebTopicName( $web, $topic ); for you (it'd make TWiki even slower) so make sure you do so.
+
## <a name="ObjectMethod <strong>get_TopicParent</strong> ("></a> [[ObjectMethod]] **getTopicParent** `($web,$topic) -> $string`
Get the name of the topic parent. Needs to be fast because of use by Render.pm.
You can save templates in other directories as long as they are listed in the `{TemplatePath}` configuration setting. The `{TemplatePath}` is defined in the Miscellaneous section of the [configure](http://www.dementia.org/twiki/configure) page.
-You can also save templates in user topics. The `{TemplatePath}` configuration setting defines which topics will be accepted as templates.
+You can also save templates in user topics (_IF_ there is no possible template match in the `templates` directory). The `{TemplatePath}` configuration setting defines which topics will be accepted as templates.
Templates that are included with an explicit `'.tmpl'` extension are looked for only in the `templates/` directory. For instance `%TMPL:INCLUDE{"example.tmpl"}%` will only return `templates/example.tmpl`, regardless of `{TemplatePath}` and SKIN settings.
<li><a href="#User Registration"> User Registration</a></li>
<li><a href="#Login Management"> Login Management</a><ul>
<li><a href="#No Login (select <code>none</code> in confi"> No Login (select none in configure)</a></li>
- <li><a href="#Template Login (select =TWiki::C"> Template Login (select TWiki::Client::TemplateLogin in configure)</a><ul>
+ <li><a href="#Template Login (select =TWiki::"> Template Login (select TWiki::LoginManager::TemplateLogin in configure)</a><ul>
<li><a href="#Enabling Template Login"> Enabling Template Login</a></li>
</ul>
</li>
- <li><a href="#Apache Login (select =TWiki::Cli"> Apache Login (select TWiki::Client::ApacheLogin in configure)</a><ul>
+ <li><a href="#Apache Login (select =TWiki::_Lo"> Apache Login (select TWiki::LoginManager::ApacheLogin in configure)</a><ul>
<li><a href="#Enabling Apache Login using =mod"> Enabling Apache Login using mod_auth</a></li>
<li><a href="#Logons via bin/logon"> Logons via bin/logon</a></li>
</ul>
## <a name="Password Management"></a> Password Management
-As shipped, TWiki supports the Apache 'htpasswd' password manager. This manager supports the use of `.htpasswd` files on the server. These files can be unique to TWiki, or can be shared with other applications (such as an Apache webserver). A variety of password encodings are supported for flexibility when re-using existing files. See the descriptive comments in the Security Settings section of the \[[http://www.dementia.org/twiki/configure]\[configure] interface for more details.
+As shipped, TWiki supports the Apache 'htpasswd' password manager. This manager supports the use of `.htpasswd` files on the server. These files can be unique to TWiki, or can be shared with other applications (such as an Apache webserver). A variety of password encodings are supported for flexibility when re-using existing files. See the descriptive comments in the Security Settings section of the [configure](http://www.dementia.org/twiki/configure) interface for more details.
You can easily plug in alternate password management modules to support interfaces to other third-party authentication databases.
The registration process is also responsible for creating user topics, and setting up the mapping information used by the User Mapping support.
+**_%X% Note:_** If you are restricting the entire %USERSWEB% web to TWikiGuest, you are required to add TWikiRegistrationAgent to ALLOWWEBCHANGE in your `%USERSWEB%/WebPreferences`. By doing so, new users are able to register without any errors.
+
<a name="LoginManagement"></a>
## <a name="Login Management"></a> Login Management
<a name="TemplateLogin"></a>
-### <a name="Template Login (select <code>TWiki::C"></a> Template Login (select =TWiki::Client::TemplateLogin in configure)
+### <a name="Template Login (select <code>TWiki::"></a><a name="Template Login (select =TWiki::_"></a> Template Login (select =TWiki::LoginManager::TemplateLogin in configure)
Template Login asks for a username and password in a web page, and processes them using whatever Password Manager you choose. Users can log in and log out. Client Sessions are used to remember users. Users can choose to have their session remembered so they will automatically be logged in the next time they start their browser.
#### <a name="Enabling Template Login"></a> Enabling Template Login
1. Use the [configure](http://www.dementia.org/twiki/configure) interface to
- 1. select the `TWiki::Client::TemplateLogin` login manager (on the Security Settings pane).
+ 1. select the `TWiki::LoginManager::TemplateLogin` login manager (on the Security Settings pane).
2. select the appropriate password manager for your system, or provide your own.
+ 3. %H% there is also an EXPERT configure setting `{TemplateLogin}{PreventBrowserRememberingPassword}` that you can set to prevent Browsers from remembering username and passwords if you are concerned about public terminal usage.
2. Register yourself in the [[TWikiRegistration]] topic. <br /> %H% Check that the password manager recognises the new user. If you are using `.htpasswd` files, check that a new line with the username and encrypted password is added to the `.htpasswd` file. If not, you probably got a path wrong, or the permissions may not allow the webserver user to write to that file.
3. Create a new topic to check if authentication works.
4. **Edit the %USERSWEB%.TWikiAdminGroup topic in the %USERSWEB% web to include users with system administrator status.**<br /> %X% **This is a very important step**, as users in this group can access _all_ topics, independent of TWiki access controls.
<a name="ApacheLogin"></a>
-### <a name="Apache Login (select <code>TWiki::Cli"></a> Apache Login (select =TWiki::Client::ApacheLogin in configure)
+### <a name="Apache Login (select <code>TWiki::_Lo"></a> Apache Login (select =TWiki::LoginManager::ApacheLogin in configure)
Using this method TWiki does not authenticate users internally. Instead it depends on the `REMOTE_USER` environment variable, which is set when you enable authentication in the webserver.
You can use any other Apache authentication module that sets REMOTE\_USER.
-1. Use [configure](http://www.dementia.org/twiki/configure#LoginManager) to select the `TWiki::Client::ApacheLogin` login manager.
+1. Use [configure](http://www.dementia.org/twiki/configure#LoginManager) to select the `TWiki::LoginManager::ApacheLogin` login manager.
2. Use [configure](http://www.dementia.org/twiki/configure#PasswordManager) to set up TWiki to create the right kind of `.htpasswd` entries.
3. Create a `.htaccess` file in the `twiki/bin` directory.<br />%H% There is an template for this file in `twiki/bin/.htaccess.txt` that you can copy and change. The comments in the file explain what need to be done.<br />%H% If you got it right, the browser should now ask for login name and password when you click on the <u>Edit</u>. If `.htaccess` does not have the desired effect, you may need to "AllowOverride All" for the directory in `httpd.conf` (if you have root access; otherwise, e-mail web server support) <br /> %X% At this time [[TWikiAccessControls]] do not control access to files in the `pub` area, unless they are only accessed through the `viewfile` script. If your `pub` directory is set up to allow open access you may want to add `.htaccess` files in there as well to restrict access
4. You can create a custom version of the [[TWikiRegistration]] form by copying the default topic, and then deleting or adding input tags in your copy. The `name=""` parameter of the input tags must start with: `"Twk0..."` (if this is an optional entry), or `"Twk1..."` (if this is a required entry). This ensures that the fields are carried over into the user home page correctly. Do **not** modify the version of [[TWikiRegistration]] shipped with TWiki, as your changes will be overwritten next time you upgrade. <br />The default new user template page is in [[%SYSTEMWEB%.NewUserTemplate|SYSTEMWEB/NewUserTemplate]]. The same variables get expanded as in the [[template topics|Main/TWikiTemplates#Template_Topics]]. You can create a custom new user home page by creating the [[%USERSWEB%.NewUserTemplate|USERSWEB/NewUserTemplate]] topic, which will then override the default.
#### <a name="Logons via bin/logon"></a> Logons via bin/logon
-Any time a user enters a page that needs authentication, they will be forced to log on. It may be convenient to have a "logon" as well, to give the system a chance to identify the user and retrieve their personal settings. It may be convenient to force them to log on.
+Any time a user requests a page that needs authentication, they will be forced to log on. It may be convenient to have a "logon" link as well, to give the system a chance to identify the user and retrieve their personal settings. It may be convenient to force them to log on.
-The <code>**bin/logon**</code> script accomplishes this. The <code>**bin/logon**</code> script must be setup in the <code>**bin/.htaccess**</code> file to be a script which requires a `valid user`. However, once authenticated, it will simply redirect the user to the view URL for the page from which the `logon` script was linked.
+The <code>**bin/logon**</code> script enables this. If you are using Apache Login, the <code>**bin/logon**</code> script must be setup in the <code>**bin/.htaccess**</code> file to be a script which requires a `valid user`. Once authenticated, it will redirect the user to the view URL for the page from which the `logon` script was linked.
<a name="TrackSessions"></a>
**_Related Topics:_** [[AdminDocumentationCategory]], [[TWikiAccessControl]], TWiki:TWiki.TWikiUserAuthenticationSupplement, TWiki:TWiki.SecuringTWikiSite
--- **_Contributors:_** TWiki:Main.PeterThoeny, TWiki:Main.MikeMannix, TWiki:Main.CrawfordCurrie
+-- **_Contributors:_** TWiki:Main.PeterThoeny, TWiki:Main.MikeMannix, TWiki:Main.CrawfordCurrie, TWiki:Main.SvenDowideit
</tr>
<tr>
<td align="right" bgcolor="#ffffff" style=""> Plugin Version: </td>
- <td bgcolor="#ffffff" style=""> 1.034 (03 Aug 2008) </td>
+ <td bgcolor="#ffffff" style=""> 1.036 (01 Oct 2008) </td>
</tr>
<tr>
<td align="right" bgcolor="#ecf2f8" style=""> Change History: </td>
<td bgcolor="#ecf2f8" style=""> </td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> 03 Aug 2008 </td>
- <td bgcolor="#ffffff" style=""> 1.034 TWiki 4.2.1 release version </td>
+ <td align="right" bgcolor="#ffffff" style=""> 30 Sep 2008 </td>
+ <td bgcolor="#ffffff" style=""> 1.035 Fix sorting of attachment date column. </td>
</tr>
<tr>
- <td align="right" bgcolor="#ecf2f8" style=""> 20 Mar 2008 </td>
- <td bgcolor="#ecf2f8" style=""> 1.033 TWikibug:Item5387: allow rowspanned columns to contain HTML tags; otherwise it is impossible to add an invisible anchor to a rowspanned cell </td>
+ <td align="right" bgcolor="#ecf2f8" style=""> 03 Aug 2008 </td>
+ <td bgcolor="#ecf2f8" style=""> 1.034 TWiki 4.2.1 release version </td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> 16 Dec 2007 </td>
- <td bgcolor="#ffffff" style=""> 1.030: Kenneth Lavrsen: Fixed the problem of tables being sorted by by [[Main/TablePlugin]] while the table is being edited by plugins such as [[Main/EditTablePlugin]]. This required adding a new attribute <code>disableallsort</code> so plugins such as [[Main/EditTablePlugin]] can temporarily disable all sorting for a table. Additionally the CGI variable (URL parameter or hidden formfield) <code>sort</code> can be set to "off" which disables all header sorting in the topic. This is used by plugins such as [[Main/EditTablePlugin]] to disable the sorting by clicking header fields during editing of tables. Ref: TWikibug:Item5135 and TWikibug:Item2690. </td>
+ <td align="right" bgcolor="#ffffff" style=""> 20 Mar 2008 </td>
+ <td bgcolor="#ffffff" style=""> 1.033 TWikibug:Item5387: allow rowspanned columns to contain HTML tags; otherwise it is impossible to add an invisible anchor to a rowspanned cell </td>
</tr>
<tr>
- <td align="right" bgcolor="#ecf2f8" style=""> 03 Dec 2007 </td>
- <td bgcolor="#ecf2f8" style=""> Arthur Clemens: Fixed rendering and order of html elements <code>thead</code>, <code>tfoot</code> and <code>tbody</code>; corrected <code>id</code> parameter. </td>
+ <td align="right" bgcolor="#ecf2f8" style=""> 16 Dec 2007 </td>
+ <td bgcolor="#ecf2f8" style=""> 1.030: Kenneth Lavrsen: Fixed the problem of tables being sorted by by [[Main/TablePlugin]] while the table is being edited by plugins such as [[Main/EditTablePlugin]]. This required adding a new attribute <code>disableallsort</code> so plugins such as [[Main/EditTablePlugin]] can temporarily disable all sorting for a table. Additionally the CGI variable (URL parameter or hidden formfield) <code>sort</code> can be set to "off" which disables all header sorting in the topic. This is used by plugins such as [[Main/EditTablePlugin]] to disable the sorting by clicking header fields during editing of tables. Ref: TWikibug:Item5135 and TWikibug:Item2690. </td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> 24 Nov 2007 </td>
- <td bgcolor="#ffffff" style=""> Arthur Clemens: Fixed sorting of columns with only icons; also removed TWiki formatting before sorting. </td>
+ <td align="right" bgcolor="#ffffff" style=""> 03 Dec 2007 </td>
+ <td bgcolor="#ffffff" style=""> Arthur Clemens: Fixed rendering and order of html elements <code>thead</code>, <code>tfoot</code> and <code>tbody</code>; corrected <code>id</code> parameter. </td>
</tr>
<tr>
- <td align="right" bgcolor="#ecf2f8" style=""> 06 Oct 2007 </td>
- <td bgcolor="#ecf2f8" style=""> 15180: PTh: Added [[TWiki/VarTABLE]] to have it listed in [[TWiki/TWikiVariables]]</td>
+ <td align="right" bgcolor="#ecf2f8" style=""> 24 Nov 2007 </td>
+ <td bgcolor="#ecf2f8" style=""> Arthur Clemens: Fixed sorting of columns with only icons; also removed TWiki formatting before sorting. </td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> 27 Jun 2007 </td>
- <td bgcolor="#ffffff" style=""> 1.024 - 1.027 Various small bug fixes. </td>
+ <td align="right" bgcolor="#ffffff" style=""> 06 Oct 2007 </td>
+ <td bgcolor="#ffffff" style=""> 15180: PTh: Added [[TWiki/VarTABLE]] to have it listed in [[TWiki/TWikiVariables]]</td>
</tr>
<tr>
- <td align="right" bgcolor="#ecf2f8" style=""> 24 Jun 2007 </td>
- <td bgcolor="#ecf2f8" style=""> 1.023: Arthur Clemens: Inline styles are now written to the head; updated default sort icons (from [[TWiki/TWikiDocGraphics]]). </td>
+ <td align="right" bgcolor="#ecf2f8" style=""> 27 Jun 2007 </td>
+ <td bgcolor="#ecf2f8" style=""> 1.024 - 1.027 Various small bug fixes. </td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> 23 Jun 2007 </td>
- <td bgcolor="#ffffff" style=""> 1.022: Arthur Clemens: Fixed styling of param <code>tablerules</code> on Internet Explorer. </td>
+ <td align="right" bgcolor="#ffffff" style=""> 24 Jun 2007 </td>
+ <td bgcolor="#ffffff" style=""> 1.023: Arthur Clemens: Inline styles are now written to the head; updated default sort icons (from [[TWiki/TWikiDocGraphics]]). </td>
</tr>
<tr>
- <td align="right" bgcolor="#ecf2f8" style=""> 23 May 2007 </td>
- <td bgcolor="#ecf2f8" style=""> 1.021: Michael Daum: Fixed css attribute priority to cooperate nicely with skin themes. </td>
+ <td align="right" bgcolor="#ecf2f8" style=""> 23 Jun 2007 </td>
+ <td bgcolor="#ecf2f8" style=""> 1.022: Arthur Clemens: Fixed styling of param <code>tablerules</code> on Internet Explorer. </td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> 27 Dec 2006 </td>
- <td bgcolor="#ffffff" style=""> 1.020: Kenneth Lavrsen: Fixed initsort so all tables can be initsorted and not only the first. When you sort a table by clicking on the header of a column the table gets sorted accordingly. When you click the header of another table the previously sorted table goes back being sorted as specified by initsort. </td>
+ <td align="right" bgcolor="#ffffff" style=""> 23 May 2007 </td>
+ <td bgcolor="#ffffff" style=""> 1.021: Michael Daum: Fixed css attribute priority to cooperate nicely with skin themes. </td>
</tr>
<tr>
- <td align="right" bgcolor="#ecf2f8" style=""> 13 Dec 2006 </td>
- <td bgcolor="#ecf2f8" style=""> 1.019: Arthur Clemens: Prevent sorting of columns that do no exist. </td>
+ <td align="right" bgcolor="#ecf2f8" style=""> 27 Dec 2006 </td>
+ <td bgcolor="#ecf2f8" style=""> 1.020: Kenneth Lavrsen: Fixed initsort so all tables can be initsorted and not only the first. When you sort a table by clicking on the header of a column the table gets sorted accordingly. When you click the header of another table the previously sorted table goes back being sorted as specified by initsort. </td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> 02 Dec 2006 </td>
- <td bgcolor="#ffffff" style=""> 1.018: Arthur Clemens: Data rows now start with first <code>datacolor</code> and <code>databgcolor</code>. </td>
+ <td align="right" bgcolor="#ffffff" style=""> 13 Dec 2006 </td>
+ <td bgcolor="#ffffff" style=""> 1.019: Arthur Clemens: Prevent sorting of columns that do no exist. </td>
</tr>
<tr>
- <td align="right" bgcolor="#ecf2f8" style=""> 26 Nov 2006 </td>
- <td bgcolor="#ecf2f8" style=""> 1.017: Arthur Clemens: Better support for <code>tablerules</code>. </td>
+ <td align="right" bgcolor="#ecf2f8" style=""> 02 Dec 2006 </td>
+ <td bgcolor="#ecf2f8" style=""> 1.018: Arthur Clemens: Data rows now start with first <code>datacolor</code> and <code>databgcolor</code>. </td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> 24 Nov 2006 </td>
- <td bgcolor="#ffffff" style=""> 1.016: Arthur Clemens: Added new attribute <code>cellborder</code>. </td>
+ <td align="right" bgcolor="#ffffff" style=""> 26 Nov 2006 </td>
+ <td bgcolor="#ffffff" style=""> 1.017: Arthur Clemens: Better support for <code>tablerules</code>. </td>
</tr>
<tr>
- <td align="right" bgcolor="#ecf2f8" style=""> 25 Oct 2006 </td>
- <td bgcolor="#ecf2f8" style=""> 1.015: Arthur Clemens: Added support for background colors of sorted column. Columns can be unsorted - sorting order is now: sort ascending, sort descending, unsort. Added attributes <code>headervalign</code> and <code>datavalign</code>. </td>
+ <td align="right" bgcolor="#ecf2f8" style=""> 24 Nov 2006 </td>
+ <td bgcolor="#ecf2f8" style=""> 1.016: Arthur Clemens: Added new attribute <code>cellborder</code>. </td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> 16 Aug 2006 </td>
- <td bgcolor="#ffffff" style=""> Michael Daum: Added CSS support for even/odd table rows </td>
+ <td align="right" bgcolor="#ffffff" style=""> 25 Oct 2006 </td>
+ <td bgcolor="#ffffff" style=""> 1.015: Arthur Clemens: Added support for background colors of sorted column. Columns can be unsorted - sorting order is now: sort ascending, sort descending, unsort. Added attributes <code>headervalign</code> and <code>datavalign</code>. </td>
</tr>
<tr>
- <td align="right" bgcolor="#ecf2f8" style=""> 13 Dec 2005 </td>
- <td bgcolor="#ecf2f8" style=""> Arthur Clemens: Added support for <code>id</code>, <code>summary</code> and <code>caption</code></td>
+ <td align="right" bgcolor="#ecf2f8" style=""> 16 Aug 2006 </td>
+ <td bgcolor="#ecf2f8" style=""> Michael Daum: Added CSS support for even/odd table rows </td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> 05 Mar 2005 </td>
- <td bgcolor="#ffffff" style=""> 1.014: Crawford Currie eliminated deprecated handlers for Dakar </td>
+ <td align="right" bgcolor="#ffffff" style=""> 13 Dec 2005 </td>
+ <td bgcolor="#ffffff" style=""> Arthur Clemens: Added support for <code>id</code>, <code>summary</code> and <code>caption</code></td>
</tr>
<tr>
- <td align="right" bgcolor="#ecf2f8" style=""> 01 Aug 2004 </td>
- <td bgcolor="#ecf2f8" style=""> Arthur Clemens: Added CSS support for first column and ascending/descending table headers </td>
+ <td align="right" bgcolor="#ecf2f8" style=""> 05 Mar 2005 </td>
+ <td bgcolor="#ecf2f8" style=""> 1.014: Crawford Currie eliminated deprecated handlers for Dakar </td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> 21 Mar 2004 </td>
- <td bgcolor="#ffffff" style=""> PTh: Internal change: Fixed reference to unofficial variable </td>
+ <td align="right" bgcolor="#ffffff" style=""> 01 Aug 2004 </td>
+ <td bgcolor="#ffffff" style=""> Arthur Clemens: Added CSS support for first column and ascending/descending table headers </td>
</tr>
<tr>
- <td align="right" bgcolor="#ecf2f8" style=""> 01 Jan 2004 </td>
- <td bgcolor="#ecf2f8" style=""> PTh: Alternating data row colors restart again after each header row </td>
+ <td align="right" bgcolor="#ecf2f8" style=""> 21 Mar 2004 </td>
+ <td bgcolor="#ecf2f8" style=""> PTh: Internal change: Fixed reference to unofficial variable </td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> 01 Dec 2003 </td>
- <td bgcolor="#ffffff" style=""> PTh: Fixed error when footerrows was specified on an empty table, contributed by TWiki:Main/PaulineCheung </td>
+ <td align="right" bgcolor="#ffffff" style=""> 01 Jan 2004 </td>
+ <td bgcolor="#ffffff" style=""> PTh: Alternating data row colors restart again after each header row </td>
</tr>
<tr>
- <td align="right" bgcolor="#ecf2f8" style=""> 24 May 2003 </td>
- <td bgcolor="#ecf2f8" style=""> PTh: New <code>|^|</code> rule for multi row span (TWiki:Main/WalterMundt); added tableframe and tablerules (TWiki:Main/JohannesMartin); ignore columnwidths for multi column span; validate headerrows and footerrows (TWiki:Main/DarrylGreen); fixed link color problem and up/down icon color problem for dark header background </td>
+ <td align="right" bgcolor="#ecf2f8" style=""> 01 Dec 2003 </td>
+ <td bgcolor="#ecf2f8" style=""> PTh: Fixed error when footerrows was specified on an empty table, contributed by TWiki:Main/PaulineCheung </td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> 17 Dec 2002 </td>
- <td bgcolor="#ffffff" style=""> PTh: Removed individual table Plugin settings; added TABLEATTRIBUTES Plugins setting and TABLEATTRIBUTES preferences setting </td>
+ <td align="right" bgcolor="#ffffff" style=""> 24 May 2003 </td>
+ <td bgcolor="#ffffff" style=""> PTh: New <code>|^|</code> rule for multi row span (TWiki:Main/WalterMundt); added tableframe and tablerules (TWiki:Main/JohannesMartin); ignore columnwidths for multi column span; validate headerrows and footerrows (TWiki:Main/DarrylGreen); fixed link color problem and up/down icon color problem for dark header background </td>
</tr>
<tr>
- <td align="right" bgcolor="#ecf2f8" style=""> 15 Dec 2002 </td>
- <td bgcolor="#ecf2f8" style=""> PTh: Added headerrows and footerrows params (TWiki:Main/DarrylGreen, TWiki:Main/WoutMertens); added tablewidth and columnwidths params (TWiki:Main/ThorstenSommermann) </td>
+ <td align="right" bgcolor="#ecf2f8" style=""> 17 Dec 2002 </td>
+ <td bgcolor="#ecf2f8" style=""> PTh: Removed individual table Plugin settings; added TABLEATTRIBUTES Plugins setting and TABLEATTRIBUTES preferences setting </td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> 09 Dec 2002 </td>
- <td bgcolor="#ffffff" style=""> PTh: Added headercolor and datacolor parameters </td>
+ <td align="right" bgcolor="#ffffff" style=""> 15 Dec 2002 </td>
+ <td bgcolor="#ffffff" style=""> PTh: Added headerrows and footerrows params (TWiki:Main/DarrylGreen, TWiki:Main/WoutMertens); added tablewidth and columnwidths params (TWiki:Main/ThorstenSommermann) </td>
</tr>
<tr>
- <td align="right" bgcolor="#ecf2f8" style=""> 05 Jun 2002 </td>
- <td bgcolor="#ecf2f8" style=""> PTh: Added "none" value to databg parameter (suggested by TWiki:Main/TaitCyrus); fixed sorting by stripping HTML tags, removing links and making sort ignore case (suggested by TWiki:Main/ShawnBradford) </td>
+ <td align="right" bgcolor="#ecf2f8" style=""> 09 Dec 2002 </td>
+ <td bgcolor="#ecf2f8" style=""> PTh: Added headercolor and datacolor parameters </td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> 13 Mar 2002 </td>
- <td bgcolor="#ffffff" style=""> PTh: Added TWiki:Main/ShawnBradford 's initsort and initdirection </td>
+ <td align="right" bgcolor="#ffffff" style=""> 05 Jun 2002 </td>
+ <td bgcolor="#ffffff" style=""> PTh: Added "none" value to databg parameter (suggested by TWiki:Main/TaitCyrus); fixed sorting by stripping HTML tags, removing links and making sort ignore case (suggested by TWiki:Main/ShawnBradford) </td>
</tr>
<tr>
- <td align="right" bgcolor="#ecf2f8" style=""> 12 Mar 2002 </td>
- <td bgcolor="#ecf2f8" style=""> PTh: Added valign, headeralign and dataalign; fixed bug of swapped cellpadding/cellspacing; fixed warning of uninitialized value </td>
+ <td align="right" bgcolor="#ecf2f8" style=""> 13 Mar 2002 </td>
+ <td bgcolor="#ecf2f8" style=""> PTh: Added TWiki:Main/ShawnBradford 's initsort and initdirection </td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> 05 Jan 2002 </td>
- <td bgcolor="#ffffff" style=""> PTh: Fixed sorting bug of cells with leading white space </td>
+ <td align="right" bgcolor="#ffffff" style=""> 12 Mar 2002 </td>
+ <td bgcolor="#ffffff" style=""> PTh: Added valign, headeralign and dataalign; fixed bug of swapped cellpadding/cellspacing; fixed warning of uninitialized value </td>
</tr>
<tr>
- <td align="right" bgcolor="#ecf2f8" style=""> 06 Dec 2001 </td>
- <td bgcolor="#ecf2f8" style=""> PTh: Fixed date sorting bug <br /> 03 Dec 2001 PTh: Fixed sort="off" bug and more </td>
+ <td align="right" bgcolor="#ecf2f8" style=""> 05 Jan 2002 </td>
+ <td bgcolor="#ecf2f8" style=""> PTh: Fixed sorting bug of cells with leading white space </td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> 29 Nov 2001 </td>
- <td bgcolor="#ffffff" style=""> PTh: Fixed Perl warnings </td>
+ <td align="right" bgcolor="#ffffff" style=""> 06 Dec 2001 </td>
+ <td bgcolor="#ffffff" style=""> PTh: Fixed date sorting bug <br /> 03 Dec 2001 PTh: Fixed sort="off" bug and more </td>
</tr>
<tr>
- <td align="right" bgcolor="#ecf2f8" style=""> 16 Nov 2001 </td>
- <td bgcolor="#ecf2f8" style=""> PTh: Added table border, cell spacing, cell padding, gif files </td>
+ <td align="right" bgcolor="#ecf2f8" style=""> 29 Nov 2001 </td>
+ <td bgcolor="#ecf2f8" style=""> PTh: Fixed Perl warnings </td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> 07 Oct 2001 </td>
- <td bgcolor="#ffffff" style=""> JT: Initial version </td>
+ <td align="right" bgcolor="#ffffff" style=""> 16 Nov 2001 </td>
+ <td bgcolor="#ffffff" style=""> PTh: Added table border, cell spacing, cell padding, gif files </td>
</tr>
<tr>
- <td align="right" bgcolor="#ecf2f8" style=""> CPAN Dependencies: </td>
- <td bgcolor="#ecf2f8" style=""> none </td>
+ <td align="right" bgcolor="#ecf2f8" style=""> 07 Oct 2001 </td>
+ <td bgcolor="#ecf2f8" style=""> JT: Initial version </td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> Other Dependencies: </td>
+ <td align="right" bgcolor="#ffffff" style=""> CPAN Dependencies: </td>
<td bgcolor="#ffffff" style=""> none </td>
</tr>
<tr>
- <td align="right" bgcolor="#ecf2f8" style=""> Perl Version: </td>
- <td bgcolor="#ecf2f8" style=""> 5.0 </td>
+ <td align="right" bgcolor="#ecf2f8" style=""> Other Dependencies: </td>
+ <td bgcolor="#ecf2f8" style=""> none </td>
+ </tr>
+ <tr>
+ <td align="right" bgcolor="#ffffff" style=""> Perl Version: </td>
+ <td bgcolor="#ffffff" style=""> 5.0 </td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> Plugin Home: </td>
- <td bgcolor="#ffffff" style=""><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%</a></td>
+ <td align="right" bgcolor="#ecf2f8" style=""> Plugin Home: </td>
+ <td bgcolor="#ecf2f8" style=""><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%</a></td>
</tr>
<tr>
- <td align="right" bgcolor="#ecf2f8" style=""> Feedback: </td>
- <td bgcolor="#ecf2f8" style=""><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev</a></td>
+ <td align="right" bgcolor="#ffffff" style=""> Feedback: </td>
+ <td bgcolor="#ffffff" style=""><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev</a></td>
</tr>
<tr>
- <td align="right" bgcolor="#ffffff" style=""> Appraisal: </td>
- <td bgcolor="#ffffff" style=""><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Appraisal" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Appraisal</a></td>
+ <td align="right" bgcolor="#ecf2f8" style=""> Appraisal: </td>
+ <td bgcolor="#ecf2f8" style=""><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Appraisal" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Appraisal</a></td>
</tr>
</table>
</tr>
<tr>
<td align="right"> Plugin Version: </td>
- <td> 03 Aug 2008 17302 (04 Aug 2008) </td>
+ <td> 03 Aug 2008 17302 (06 Dec 2008) </td>
</tr>
<tr>
<td align="right"> Copyright: </td>
</tr>
<tr>
<td align="right"> Version: </td>
- <td> 15675 (04 Aug 2008) </td>
+ <td> 17595 (06 Dec 2008) </td>
</tr>
<tr>
<td align="right"> Change History: </td>
%TWISTY{
showlink="Show..."
- hidelink="Hide
+ hidelink="Hide"
start="hide"
}%
my twisty content
%ENDTWISTY%
-<span><span>[<span>Show...</span>](#)</span><span>[<span>Hide start=</span>](#)</span></span>
+<span><span>[<span>Show...</span>](#)</span><span>[<span>Hide</span>](#)</span></span>
<div style="display: inline"><span id="twistyId7toggle"> %GREEN% my twisty content %ENDCOLOR% </span></div>
#### <a name="Header%_TWISTYSCRIPT{"TWiki._Twi"></a> <span><span>[<span>Header</span>](#)</span><span>[<span>Header</span>](#)</span></span>
-<div style="display: inline"><span id="twistyId12toggle"> %GREEN% my twisty content %ENDCOLOR% </span></div>
+<div style="display: inline">
+ <div id="twistyId12toggle"> %GREEN% my twisty content %ENDCOLOR% </div>
+</div>
### <a name="All on, all off"></a> All on, all off
<tr>
<td><code>mode</code></td>
<td><code>"div"</code> or <code>"span"</code></td>
- <td> Specify if the Twisty Toggle section will use a <code><div></code> or a <code><span></code> tag. </td>
+ <td> Specify if the Twisty Toggle section will use a <code><div></code> or a <code><span></code> tag. Note that if the contents contains block elements such as <code>div</code>, <code>mode</code> should be <code>div</code> as well to create valid HTML markup. </td>
<td> optional, defaults to <code><span></code></td>
</tr>
<tr>
<tr>
<td><code>mode</code></td>
<td><code>"div"</code> or <code>"span"</code></td>
- <td> Specify if the <strong>Twisty button</strong> will use a <code><div></code> or a <code><span></code> tag </td>
+ <td> Specify if the <strong>Twisty button</strong> will use a <code><div></code> or a <code><span></code> tag. Note that if the contents contains block elements such as <code>div</code>, <code>mode</code> should be <code>div</code> as well to create valid HTML markup. </td>
<td> optional, defaults to <code><span></code></td>
</tr>
</table>
</li>
+ <li> Example: <code>%TWISTYBUTTON{id="myid" link="more"}%%TWISTYTOGGLE{id="myid"}%content%ENDTWISTYTOGGLE%</code></li>
<li> Related: [[Main/WebHome#VarTWISTYSHOW]] and [[Main/WebHome#VarTWISTYHIDE]]</li>
</ul>
<p><a name="VarTWISTYSHOW"></a></p>
<tr>
<td><code>mode</code></td>
<td><code>"div"</code> or <code>"span"</code></td>
- <td> Specify if the Twisty Show link will use a <code><div></code> or a <code><span></code> tag </td>
+ <td> Specify if the Twisty Show link will use a <code><div></code> or a <code><span></code> tag. Note that if the contents contains block elements such as <code>div</code>, <code>mode</code> should be <code>div</code> as well to create valid HTML markup. </td>
<td> optional, defaults to <code><span></code></td>
</tr>
<tr>
<tr>
<td><code>mode</code></td>
<td><code>"div"</code> or <code>"span"</code></td>
- <td> Specify if the Twisty Hide link will use a <code><div></code> or a <code><span></code> tag </td>
+ <td> Specify if the Twisty Hide link will use a <code><div></code> or a <code><span></code> tag. Note that if the contents contains block elements such as <code>div</code>, <code>mode</code> should be <code>div</code> as well to create valid HTML markup. </td>
<td> optional, defaults to <code><span></code></td>
</tr>
<tr>
<tr>
<td><code>mode</code></td>
<td><code>"div"</code> or <code>"span"</code></td>
- <td> Specify if the Twisty Toggle section will use a <code><div></code> or a <code><span></code> tag. </td>
+ <td> Specify if the Twisty Toggle section will use a <code><div></code> or a <code><span></code> tag. Note that if the contents contains block elements such as <code>div</code>, <code>mode</code> should be <code>div</code> as well to create valid HTML markup. </td>
<td> optional, defaults to <code><span></code></td>
</tr>
<tr>
</tr>
<tr>
<td align="right"> Copyright ©: </td>
- <td> 2005 Rafael Alvarez; 2006, 2007 Arthur Clemens </td>
+ <td> 2005 Rafael Alvarez; 2006-2008 Arthur Clemens </td>
</tr>
<tr>
<td align="right"> License: </td>
</tr>
<tr>
<td align="right"> Plugin Version: </td>
- <td> 03 Aug 2008 (version 1.4.10) </td>
+ <td> 10 Oct 2008 (version 1.4.12) </td>
</tr>
<tr>
<td align="right"> Change History: </td>
<td> </td>
</tr>
<tr>
+ <td align="right"> 08 Oct 2008 </td>
+ <td> 1.4.11, 1.4.12 It is now possible to have a twisty on the same line without a linebreak. </td>
+ </tr>
+ <tr>
<td align="right"> 03 Aug 2008 </td>
<td> 1.4.10 TWiki 4.2.1 release version </td>
</tr>
--- /dev/null
+<a name="VarEDITACTION"></a>
+
+### <a name="EDITACTION -- Selects an edit te"></a> EDITACTION -- Selects an edit template
+
+- EDITACTION defined in a topic or preference setting will define the use of an editaction template instead of the standard edit. If EDITACTION is defined as `text`, then hide the form. If EDITACTION is defined as `form` hide the normal text area and only edit the form.
+- Syntax: Set EDITACTION = text|form
+- Expands to: %EDITACTION%
+- Related: [[TWikiScripts#edit]]
+- %X% When EDITACTION is defined as text or form the Edit and Edit Raw buttons simply add `;action=text` or `;action=form` to the URL for the edit script. If you have defined EDITACTION in a topic setting or preference setting you can still edit the topic content or the form by removing the `;action=form` or `;action=text` from the edit URL in the browser and reload.
<td><code>EDITBUTTON</code> %BR% plugin setting </td>
</tr>
<tr>
+ <td><code>buttonrow</code></td>
+ <td> Set to <code>top</code> to put the edit buttons above the table. </td>
+ <td><code>bottom</code></td>
+ </tr>
+ <tr>
<td><code>javascriptinterface</code></td>
<td> Use javascript to directly move and delete row without page refresh. Enable with <code>"on"</code>, disable with <code>"off"</code>. </td>
<td><code>JAVASCRIPTINTERFACE</code> %BR% plugin setting </td>
</table>
- Example: `%URLPARAM{"skin"}%` returns `print` for a `.../view/%WEB%/%INCLUDINGTOPIC%?skin=print` URL
- **_%X% Notes:_**
- - URL parameters passed into HTML form fields must be entity [[ENCODEd|Main/VarENCODE]].
+ - **IMPORTANT:** There is a risk that this variable could be misused for [cross-site scripting](http://en.wikipedia.org/wiki/Cross-site_scripting) (XSS).
+ - URL parameters passed into HTML form fields **_must be_** entity [[ENCODEd|Main/VarENCODE]].%BR% Example: `<input type="text" name="address" value="%URLPARAM{ "address" encode="entity" }%" />`
- Double quotes in URL parameters must be escaped when passed into other TWiki variables.%BR% Example: `%SEARCH{ "%URLPARAM{ "search" encode="quotes" }%" noheader="on" }%`
- When used in a template topic, this variable will be expanded when the template is used to create a new topic. See [[TWikiTemplates#TemplateTopicsVars]] for details.
- Watch out for TWiki internal parameters, such as `rev`, `skin`, `template`, `topic`, `web`; they have a special meaning in TWiki. Common parameters and view script specific parameters are documented at [[TWikiScripts]].
- If you have `%URLPARAM{` in the value of a URL parameter, it will be modified to `%<nop>URLPARAM{`. This is to prevent an infinite loop during expansion.
- - There is a risk that this variable could be misused for cross-site scripting.
- Related: [[ENCODE|Main/VarENCODE]], [[SEARCH|Main/VarSEARCH]], [[FormattedSearch]], [[QUERYSTRING|Main/VarQUERYSTRING]]
%STARTINCLUDE%<link rel="self" type="application/atom+xml" href="%SCRIPTURL{"view"}%/%INCLUDINGWEB%/%BASETOPIC%"/>
<id>%SCRIPTURL{"view"}%/%INCLUDINGWEB%</id>
<rights>%WEBRSSCOPYRIGHT%</rights>%CALC{$SET(c,0)}%
- %SEARCH{"%URLPARAM{"search" default=".*" }%" web="%INCLUDINGWEB%" type="regex" nosearch="on" order="modified" reverse="on" nototal="on" limit="16" format="$percntCALC{$IF($GET(c)>0, , <updated>$isodate</updated>$CHAR(10))$SETM(c, +1)}$percnt<entry>$n <title>$topic</title>$n <link rel=\"alternate\" type=\"text/html\" href=\"%SCRIPTURL{"view"}%/$web/$topic?t=$isodate\"/>$n <id>%SCRIPTURL{"view"}%/$web/$topic</id>$n <updated>$isodate</updated>$n <summary>$summary (last changed by <nop>$wikiname)</summary>$n <author>$n <name><nop>$wikiname</name></author>$n</entry>"}%
+ %SEARCH{"%URLPARAM{"search" encode="quote" default=".*" }%" web="%INCLUDINGWEB%" type="regex" nosearch="on" order="modified" reverse="on" nototal="on" limit="16" format="$percntCALC{$IF($GET(c)>0, , <updated>$isodate</updated>$CHAR(10))$SETM(c, +1)}$percnt<entry>$n <title>$topic</title>$n <link rel=\"alternate\" type=\"text/html\" href=\"%SCRIPTURL{"view"}%/$web/$topic?t=$isodate\"/>$n <id>%SCRIPTURL{"view"}%/$web/$topic</id>$n <updated>$isodate</updated>$n <summary>$summary (last changed by <nop>$wikiname)</summary>$n <author>$n <name><nop>$wikiname</name></author>$n</entry>"}%
%STOPINCLUDE%
----
<dc:source>%WIKITOOLNAME%</dc:source>
<items>
<rdf:Seq>
- %SEARCH{"%URLPARAM{"search" default=".*" }%" web="%URLPARAM{"web" default="%INCLUDINGWEB%" }%" excludetopic="%URLPARAM{"excludetopic" default="WebStatistics" }%" type="%URLPARAM{"type" default="regex" }%" nosearch="on" order="modified" reverse="on" nototal="on" limit="%URLPARAM{"limit" default="16" }%" scope="%URLPARAM{"scope" default="text" }%" casesensitive="%URLPARAM{"casesensitive" default="on" }%" date="%URLPARAM{"date" default="" }%" format=" <rdf:li rdf:resource=\"%SCRIPTURL{"view"}%/$web/$topic\" />"}%
+ %SEARCH{"%URLPARAM{"search" encode="quote" default=".*" }%" web="%URLPARAM{"web" encode="quote" default="%INCLUDINGWEB%" }%" excludetopic="%URLPARAM{"excludetopic" encode="quote" default="WebStatistics" }%" type="%URLPARAM{"type" encode="quote" default="regex" }%" nosearch="on" order="modified" reverse="on" nototal="on" limit="%URLPARAM{"limit" encode="quote" default="16" }%" scope="%URLPARAM{"scope" encode="quote" default="text" }%" casesensitive="%URLPARAM{"casesensitive" encode="quote" default="on" }%" date="%URLPARAM{"date" encode="quote" default="" }%" format=" <rdf:li rdf:resource=\"%SCRIPTURL{"view"}%/$web/$topic\" />"}%
</rdf:Seq>
</items>
</channel>
<link>%SCRIPTURL{"view"}%/%INCLUDINGWEB%</link>
<url>%WIKILOGOIMG%</url>
</image>
- %SEARCH{"%URLPARAM{"search" default=".*" }%" web="%URLPARAM{"web" default="%INCLUDINGWEB%" }%" excludetopic="%URLPARAM{"excludetopic" default="WebStatistics" }%" type="%URLPARAM{"type" default="regex" }%" nosearch="on" order="modified" reverse="on" nototal="on" limit="%URLPARAM{"limit" default="16" }%" scope="%URLPARAM{"scope" default="text" }%" casesensitive="%URLPARAM{"casesensitive" default="on" }%" date="%URLPARAM{"date" default="" }%" format="<item rdf:about=\"%SCRIPTURL{"view"}%/$web/$topic\">$n <title>$topic</title>$n <link>%SCRIPTURL{"view"}%/$web/$topic</link>$n <description>$summary (last changed by <nop>$wikiname)</description>$n <dc:date>$isodate</dc:date>$n <dc:contributor>$n <rdf:Description link=\"%SCRIPTURL{"view"}%?topic=$wikiusername\">$n <rdf:value>$username</rdf:value>$n </rdf:Description>$n </dc:contributor>$n</item>"}%
+ %SEARCH{"%URLPARAM{"search" encode="quote" default=".*" }%" web="%URLPARAM{"web" encode="quote" default="%INCLUDINGWEB%" }%" excludetopic="%URLPARAM{"excludetopic" encode="quote" default="WebStatistics" }%" type="%URLPARAM{"type" encode="quote" default="regex" }%" nosearch="on" order="modified" reverse="on" nototal="on" limit="%URLPARAM{"limit" encode="quote" default="16" }%" scope="%URLPARAM{"scope" encode="quote" default="text" }%" casesensitive="%URLPARAM{"casesensitive" encode="quote" default="on" }%" date="%URLPARAM{"date" encode="quote" default="" }%" format="<item rdf:about=\"%SCRIPTURL{"view"}%/$web/$topic\">$n <title>$topic</title>$n <link>%SCRIPTURL{"view"}%/$web/$topic</link>$n <description>$summary (last changed by <nop>$wikiname)</description>$n <dc:date>$isodate</dc:date>$n <dc:contributor>$n <rdf:Description link=\"%SCRIPTURL{"view"}%?topic=$wikiusername\">$n <rdf:value>$username</rdf:value>$n </rdf:Description>$n </dc:contributor>$n</item>"}%
%STOPINCLUDE%
----
<form action="http://www.dementia.org/twiki/view/%INCLUDINGWEB%/%INCLUDINGTOPIC%" id="twikiWebSearchForm">
<table border="0" cellpadding="0" cellspacing="0" id="twikiSearchTable">
<tr>
- <td colspan="2"><input name="search" size="40" type="text" value="" /> <input type="submit" value="Search" /><span> [[%INCLUDINGWEB%/WebSearchAdvanced?search=;type=word;scope=;web=;nosearch=]] | [[SYSTEMWEB/SearchHelp]]</span><div style="padding: 1em 0 0 0">TIP: to search for all topics that contain <code>"SOAP"</code>, <code>"WSDL"</code>, a literal <code>"web service"</code>, but not <code>"shampoo"</code>, write: <code>soap wsdl "web service" -shampoo</code></div>
+ <td colspan="2"><input name="search" size="40" type="text" value="" /> <input type="submit" value="Search" /><span> [[%INCLUDINGWEB%/WebSearch?search=;type=word;scope=;web=;nosearch=]] | [[SYSTEMWEB/SearchHelp]]</span><div style="padding: 1em 0 0 0">TIP: to search for all topics that contain <code>"SOAP"</code>, <code>"WSDL"</code>, a literal <code>"web service"</code>, but not <code>"shampoo"</code>, write: <code>soap wsdl "web service" -shampoo</code></div>
</td>
</tr>
<tr>
1. The HTML for the content-to-be-edited can be generated directly in the standard edit template.
2. The HTML for the content-to-be-edited can be generated directly in a specialised edit template.
3. A URL can be used to fetch the content-to-be-edited from the server, for use in an IFRAME.
-4. REST handlers can be called from Javacript to convert content.
+4. REST handlers can be called from Javascript to convert content.
#### <a name="Generating content directly in t"></a> Generating content directly in the standard edit template
<table border="1" cellpadding="0" cellspacing="0">
<tr>
- <td align="right"> Plugin Authors: </td>
+ <td align="right"> Plugin Author(s): </td>
<td> TWiki:Main.CrawfordCurrie <a href="http://www.c-dot.co.uk" target="_top">http://www.c-dot.co.uk</a></td>
</tr>
<tr>
</tr>
<tr>
<td align="right"> Plugin Version: </td>
- <td> 03 Aug 2008 17302 (04 Aug 2008) </td>
+ <td> 17680 (06 Dec 2008) </td>
</tr>
<tr>
<td align="right"> Change History: </td>
<td> </td>
</tr>
<tr>
- <td align="right"> 03 Aug 2008 </td>
+ <td align="right"> 22 Oct 2008 </td>
+ <td> Fixed TWikibug:Item5961 (emphasis), TWikibug:Item6089 (backslash in verbatim) </td>
+ </tr>
+ <tr>
+ <td align="right"> 7 Aug 2008 </td>
+ <td> Fixed TWikibug:Item5707 (mod_perl) </td>
+ </tr>
+ <tr>
+ <td align="right"> 3 Aug 2008 </td>
<td> TWiki 4.2.1 release version </td>
</tr>
<tr>
<td align="left">>=1.25</td>
<td align="left">Required. Available from <a href="http://cpan.uwinnipeg.ca/search?query=HTML%3A%3AEntities&mode=dist" target="_top">CPAN</a>.</td>
</tr>
+ <tr>
+ <td align="left">Encode</td>
+ <td align="left">>=2.01</td>
+ <td align="left">Required.</td>
+ </tr>
</table>
</td>
</tr>
git://git.openafs.org / openafs-wiki.git / commitdiff