In order to use the DR_Wiki, you have to take the following steps:
- Figure 11: Step 2
Insert the extension into a page, by using either the context menu of the Typo3 page-tree or the “Create page content” button.
- Figure 12: Step 3
Click on the “DR_Wiki” icon in the content element menu, to insert the extension into a page.
If necessary set the “Startingpoint” for the plug-in in the FlexForm configuration tabs and click on the “Save” button to store the changes. Further configuration parameters can be found in the following chapter.
This section describes the configuration values that can be used to configure the Wiki extension. All the options and values are set in a FlexForm, allowing an easy configuration of “DR_Wiki”.
General Settings
Startingpoint | Select manually the page where the DR_Wiki data will be taken from. Default value is the page where the extension is installed. |
Recursive | Can be set but is generally not necessary. Includes the sub-pages to be searched for Wiki database entries. |
TOC settings
Disable the creation of table contents | True or false. By default, this option is false. |
Maximum level of headings to create TOC | Enter the favoured maximum level of headings. The default level is 4. |
Minimum count of headers for displaying the TOC | Use this option to limit the count of headers in your TOC. Default value is 4 headers for the creation of a TOC. |
Disable the numbering of heading | True or false. By default, this option is false. |
Editor Settings
Number of editor lines (Default: 30) | Numeric. Default value is 30 lines. |
Number of editor columns (Default: 50) | Numeric. Default value is 50 columns. |
Turn on line wrapping? | Change the wrapping of lines in the editor field. True or false. By default, this option is false. |
Summary characters | Define the number of characters in the summary field. |
Advanced Settings
Set template for DR_Wiki | Use this field to set an alternative template. |
Make the Wiki read only | Activate this button to set the complete Wiki to read-only. True or false. By default, this option is false and so the Wiki is editable. |
Deactivate caching of Wiki pages? | This function deactivates the pre-rendering of Wiki pages. True or false. By default, this option is false. |
Target for external links | Choose between _self, _parent, _top. Default configuration is “_blank” (displays external link in a new window). |
Turn off image links? | Toggles the inclusion of a link-image. True or false. By default, this option is false. |
Redirect Settings
Redirect edit-user to login page if not logged-in? | If this option is set, the user will be redirected to a login or information page if he or she is not logged in and tries to edit a Wiki page. True or false. By default, this option is false. |
Page to use if redirecting is active. | Page that is used for the redirect. “Redirect edit-user” needs to be set. Default value is the page where the extension is installed. |
The following Cascading Stylesheets (CSS) are used by dr_wiki. They are defined in the setup variable _CSS_DEFAULT_STYLE.
plugin.tx_drwiki_pi1._CSS_DEFAULT_STYLE (
.tx-drwiki-pi1 A { TEXT-DECORATION: none; } .tx-drwiki-pi1 A:hover { TEXT-DECORATION: underline; } .tx-drwiki-pi1 H1 { FONT-SIZE: 188%; FONT-WEIGHT:
normal; BACKGROUND:
none transparent scroll repeat 0% 0%;
PADDING-BOTTOM: 0.17em;
MARGIN: 0px;
COLOR: black;
PADDING-TOP: 0.5em;
BORDER-BOTTOM: #aaaaaa 1px solid }
.tx-drwiki-pi1 H2 { FONT-SIZE: 150%;
FONT-WEIGHT: normal;
BACKGROUND: none transparent scroll repeat 0% 0%;
PADDING-BOTTOM: 0.17em;
MARGIN: 0px; COLOR: black;
PADDING-TOP: 0.5em;
BORDER-BOTTOM: #aaaaaa 1px solid }
.tx-drwiki-pi1 H3 { FONT-SIZE: 132%;
FONT-WEIGHT: bold;
BACKGROUND: none transparent scroll repeat 0% 0%;
PADDING-BOTTOM: 0.17em; MARGIN: 0px;
COLOR: black; PADDING-TOP: 0.5em; }
.tx-drwiki-pi1 H4 { FONT-SIZE: 116%;
FONT-WEIGHT: bold;
BACKGROUND: none transparent scroll repeat 0% 0%;
PADDING-BOTTOM: 0.17em;
MARGIN: 0px;
COLOR: black;
PADDING-TOP: 0.5em; }
.tx-drwiki-pi1 H5 { FONT-SIZE: 100%;
FONT-WEIGHT: bold;
BACKGROUND: none transparent scroll repeat 0% 0%;
PADDING-BOTTOM: 0.17em;
MARGIN: 0px;
COLOR: black;
PADDING-TOP: 0.5em; }
.tx-drwiki-pi1 H6 { FONT-SIZE: 80%;
FONT-WEIGHT: bold;
BACKGROUND: none transparent scroll repeat 0% 0%;
PADDING-BOTTOM: 0.17em;
MARGIN: 0px;
COLOR: black;
PADDING-TOP: 0.5em; }
.tx-drwiki-pi1 HR { height:1px;
border-top:1px dotted #000000;
border-left:0;
border-right:0;
border-bottom:0; }
.tx-drwiki-pi1 OL {PADDING-RIGHT: 0px;
PADDING-LEFT: 0px;
PADDING-BOTTOM: 0px;
MARGIN: 0.3em 0px 0px 3.2em;
LINE-HEIGHT: 1.5em;
PADDING-TOP: 0px;}
.tx-drwiki-pi1 UL {PADDING-RIGHT: 0px;
PADDING-LEFT: 0px;
PADDING-BOTTOM: 0px;
MARGIN: 0.3em 0px 0px 1.5em;
LINE-HEIGHT: 1.5em;
PADDING-TOP: 0px; }
.tx-drwiki-pi1 PRE { BORDER: #2f6fab 1px dashed;
PADDING: 1em;
COLOR: black;
LINE-HEIGHT: 1.1em;
BACKGROUND-COLOR: #f9f9f9;
font-family:Fixedsys,Courier; }
.tx-drwiki-pi1 INPUT {font-size:10pt;} .tx-drwiki-pi1 TEXTAREA {width:100%; font-size:10pt;} .tx-drwiki-pi1 input, textarea {border: 1px #ccc solid;
background: #fafafa;
color: #777;}
.tx-drwiki-pi1 input[type=text]:focus, textarea:focus{ background: #f0f0f0;
color: #333;
border-color: #666;}
.tx-drwiki-pi1-urlextension { display: none; } .redirect {BORDER: #2f6fab 1px dashed;
PADDING: 1em;
COLOR: black;
LINE-HEIGHT: 1.1em;
BACKGROUND-COLOR: #FFFFF0;}
.icons {vertical-align:middle;
float:left;
margin-right:20px;
margin-bottom:10px;}
.wiki-box {BORDER: #2f6fab 1px dashed;
PADDING: 1em;
COLOR: black;
LINE-HEIGHT: 1.1em;
BACKGROUND-COLOR: #f9f9f9; }
.wiki-box-blue {display: block;
font-size: 1em;
color: #000;
padding: 0.5em;
background: #f0f0f4;
border-left: 8px #E0E7F5 solid;}
.wiki-box-red {display: block;
font-size: 1em;
color: #000;
padding: 0.5em;
background: #fee;
border-left: 8px #fcc solid;}
.wiki-box-green {display: block;font-size: 1em;
color: #000;
padding: 0.5em;
background: #33FF33;
border-left: 8px #006600 solid;}
.wiki-box-yellow {display: block;
font-size: 1em;
color: #000;
padding: 0.5em;
background: #FFFF99;
border-left: 8px #FFFF00 solid;}
.wiki-table {margin: 1em 1em 1em 0;
background: #f9f9f9;
border: 1px #aaa solid;
border-collapse: collapse;}
.diff-r {color: red;} .diff-g {color: green;} .diff-result { BORDER: #2f6fab 1px dashed;
PADDING: 1em;
COLOR: black;
LINE-HEIGHT: 1.1em;
BACKGROUND-COLOR: #f9f9f9;
font-family:Fixedsys,Courier; }
.diff-table {width:100%;} .diff-table-cell-green {vertical-align:top;
text-align:left;
white-space:normal;
color:green; font-family:Fixedsys,Courier;
font-size:10pt;
BORDER: #2f6fab 1px dashed;
PADDING: 1em;}
.diff-table-cell-red {vertical-align:top;
text-align:left;
white-space:normal;
color:red;
font-family:Fixedsys,Courier;
font-size:10pt;
BORDER: #2f6fab 1px dashed;
PADDING: 1em;}
#toc {BORDER: #aaaaaa 1px solid;
PADDING: 5px;
FONT-SIZE: 10pt;
BACKGROUND-COLOR: #f9f9f9 }
#toc .tocindent {MARGIN-LEFT: 2em} #toc .tocline {MARGIN-BOTTOM: 0px} #toc P {FONT-SIZE: 10pt; MARGIN: 0px} #toc .toctoggle {FONT-SIZE: 10pt} #toc .editsection {MARGIN-TOP: 0.7em; FONT-SIZE: 10pt})
This section describes how to configure your Typo3 website to use realURL and dr_wiki. For a detailed overview on realURL, please refer to its extension manual.
The configuration used here was tested with version 1.1.4 of RealURL (http://typo3.org/extensions/repository/view/realurl/1.1.4/) and Typo3 (http://www.typo3.org) versions 3.8.1 following.
TypoScript Configuration
The following needs to be added to the TypoScript template, otherwise the page navigation maps of the wiki will not work.
config {simulateStaticDocuments = 0
baseURL = http://www.yoursite.de/
tx_realurl_enable = 1
inlineStyle2TempFile = 1
# the next line is necessary to make the anchors work again
prefixLocalAnchors = output
}
Especially the baseURL and the prefixLocalAnchors are the important properties to be set.
realURL Configuration
In order to make dr_wiki working with realURL, the following code has to be added to your configuration:
$TYPO3_CONF_VARS['EXTCONF']['myPostVarSets'] = array(
'_DEFAULT' => array (
'wiki' => array(
array(
'GETvar' => 'tx_drwiki_pi1[keyword]',
),
array(
'GETvar' => 'tx_drwiki_pi1[showUid]',
),
array(
'GETvar' => 'tx_drwiki_pi1[cmd]',
),
),
),
);
