Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
dokuwiki:server [2020/08/13 17:19] Bernard Condraudokuwiki:server [2024/04/25 18:56] (current) Bernard Condrau
Line 37: Line 37:
   * Add "_blank" to "Target window for external links" and "Target window for media links" under //Links// in DokuWiki's //Configuration Settings//.   * Add "_blank" to "Target window for external links" and "Target window for media links" under //Links// in DokuWiki's //Configuration Settings//.
 ==== Customization ==== ==== Customization ====
-There are a few core hacks required to make this work as a help server, but they are simple and thus easy to maintain, even after an update of DokuWiki or any of the extensions+There are a few core hacks required to make my template work properly, both for a regular wiki as well as for a help server. <span orange>**Note: you need to verify below modifications after every DokuWiki upgrade.**</span> 
-  * Copy 'doku.phpto 'help.phpin the DokuWiki root folder +  - Install my {{ :dokuwiki:tpl_bethico.zip |Bethico Template}} into ''/lib/tpl/''. Current version is 2022-10-09 suitable for DokuWiki "Igor". 
-  * Create the language fallback to English for non-existent translation pages by adding 3 lines to /help.php at line #41, just below '$ID = getID();'Remember to update after you add or remove languages.<code>// bco: 20181114. Get requested language and set language fallback +  - Add the following lines in ''doku.php'' in DokuWiki's root after line ''$ID = getID();'' at the beginning...<file>require_once(template('dispatcher.php')); 
-require_once(template('dispatcher.php')); +$langcode = bethico_language();</file
-$langcode = help_language();</code+  - ...and replace at the end line ''act_dispatch();'' with<file>init_lang($langcode); 
-  * Modify 'help.php' and replace line #119+4 and #120+4<code>//do the work (picks up what to do from global env) +bethico_dispatch(basename(__FILE__));</file
-act_dispatch();</code>with<code>// bco: 20181114. Set language and load act_dispatch override +  - Copy ''doku.php'' to ''help.php'' in the DokuWiki root folder 
-init_lang($langcode); +  - Modify ''/inc/template.php'' and add before line ''Event::createAndTrigger('TPL_TOC_RENDER', $toc, null, false);'' in function ''tpl_toc''This is a non-destructive change which fixes an issue in the table of contents if plugin ''condition'' is installed in the wiki<file>if (@include_once(template('dispatcher.php'))) bethico_update_toc($toc, $TOC);</file
-help_dispatch();</code+  - Copies of the modified files for "Igor" are in folder ''/lib/tpl/bethico/core/'', copy them with<file>cp -R /lib/tpl/bethico/core//</file> 
-  Modify '/inc/template.php' and add after line #130 ($toc = $TOC) in function tpl_toc<code>// bco: 20181116Fix toc issues due to use of condition Plugin +  - After a DokuWiki upgrade check and change if necessary 
-require_once(template('dispatcher.php'))+    - Check ''/inc/actions.php'' and change ''/lib/tpl/bethico/dispatcher.php'
-help_toc($toc); +    - Check ''/inc/template.php'' and change 
-</code+    - Check ''/doku.php'' and change then copy to ''/help.php'' 
-  * After a DokuWiki upgrade make sure that +  Optional: replace favicon and logo in '/lib/tpl/bethico/images/'. 
-    * If '/inc/actions.php' has been upgraded, reflect the changes in '/lib/tpl/bethico/dispatcher.php' +
-    * If '/inc/template.php' has been upgraded, reflect the changes in function tpl_toc +
-    * If '/doku.php' has been upgraded, reflect the changes in '/help.php' +
-  * If you use a template other than 'bethico', you must copy '/lib/tpl/bethico/css/userstyle.css' to '/conf+
-  Optional: replace favicon and logo in '/lib/tpl/bethico/images/'.+
  
-==== The following files must be checked against the previous version after upgrading ==== 
-^ File ^ DokuWiki File ^ Todo ^ 
-| help.php | doku.php | line 12: $updateVersion and verify content (compare doku.php to previous version) | 
-| inc/template.php | inc/template.php | line 131-133: call to //help_toc// in function //tpl_toc// | 
-| lib/tpl/bethico/dispatcher.php | inc/actions.php | verify function //help_dispatch// | 
 ===== Joomla Access ===== ===== Joomla Access =====
   * Set the Help URL in the component configuration of com_bethico to<code>'https://your.wiki.server/help.php?id={langcode}:{keyref}'</code>   * Set the Help URL in the component configuration of com_bethico to<code>'https://your.wiki.server/help.php?id={langcode}:{keyref}'</code>
Line 80: Line 71:
 | {minor} | Joomla minor version number || | {minor} | Joomla minor version number ||
 | {maintenance} | Joomla maintenance version number || | {maintenance} | Joomla maintenance version number ||
 +
 +===== Backup with zip =====
 +  * use the following command to backup an entire wiki with zip<code>$ sudo zip -r my_wiki my_wiki -x my_wiki/data/cache/**\* my_wiki my_wiki -x my_wiki/data/log/error/**\* my_wiki my_wiki -x my_wiki/data/log/deprecated/**\*</code>
  
 ===== Upgrade to Version 2020-07-29 "Hogfather" ===== ===== Upgrade to Version 2020-07-29 "Hogfather" =====
Line 98: Line 92:
   * [[https://www.dokuwiki.org/tips:safely_include_php_code|Safely include PHP code]]   * [[https://www.dokuwiki.org/tips:safely_include_php_code|Safely include PHP code]]
   * [[https://www.splitbrain.org/personal|Andreas Gohr]]   * [[https://www.splitbrain.org/personal|Andreas Gohr]]
 +  * [[https://www.plothost.com/kb/update-dokuwiki-command-line/|How to update DokuWiki from the command line]]
 +===== PHP 8.1 issues =====
 +==== Plugin condition ====
 +  * Replace curly brackets string indices with square brackets in line 84 and 149 of ''plugins/condition/syntax.php'' if you run your webserver with PHP 8.
 +
 +==== Plugin html5video ====
 +  * Put brackets enclosing the expressions on line 190 and 191 of ''plugins/html5video/syntax/video.php'' if you run your webserver with PHP 8.
 +
 +===== davcal =====
 +==== Check when a date entry was made ====
 +  - Copy ''/data/meta/davcal.sqlite3'' to D:\
 +  - Open ''sqlite3.exe'' command line tool from D:\PortableCustom\sqlite3, then enter the following commands to see entries made after 2023-01-01:<code>.open /davcal.sqlite3
 +SELECT calendardata FROM calendarobjects WHERE datetime(lastoccurence, 'unixepoch') > '2023-01-01 00:00:00';
 +.quit</code>
 +