Differences

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

--- plugin:farm [2010-11-27 23:51] – [Bugs] lupo49
+++ plugin:farm [2022-01-07 20:25] (current) – obsolete Klap-in
@@ Line 1: / Line 1: @@
-====== farm plugin ======
+====== The Farm Plugin ======
+In a farm, one single copy of wiki engine (the farmer) is used to run several individual wikis (the animals).
+:!: For general, relevant and up-to-date instructions see [[:farms]].
+This page describes a plugin that automatizes the [[tips:redirect farm|redirect]] approach to farming. Be aware this could be out-dated.
+===== Status =====
 ---- plugin ----
@@ Line 10: / Line 19: @@
 depends    :
 conflicts  :
-similar    :
+similar    : farmer
-tags       : farm farming
+tags       : farm, !obsolete
-downloadurl: http://sourcesup.cru.fr/dwfarmplugin/farm.zip
+downloadurl: # http://sourcesup.cru.fr/dwfarmplugin/farm.zip
 bugtracker :
 sourcerepo :
 donationurl:
 ----
+:!: not available: http://sourcesup.cru.fr/dwfarmplugin/farm.zip. Contains only setup data of 2010 version.
 ===== Download and Installation =====
-Download and install the plugin using the [[plugin:plugin|Plugin Manager]] using the following URL. Refer to [[:Plugins]] on how to install plugins manually.
+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
-^ Download | [[http://sourcesup.cru.fr/dwfarmplugin/farm.zip|farm.zip]] | Up 2010-01-18 |
 ===== Description =====
@@ Line 31: / Line 44: @@
 It is a compilation of techniques discussed here, in the form of a plugin:
-  * [[doku>devel:farm|devel:farm]]
+  * [[devel:farm|devel:farm]]
-  * [[doku>tips:farm|tips:farm]]
+  * [[tips:farm|tips:farm]]
+For people who can read French, here is my article from JRES2009 about this technique and plugin: {{https://2009.jres.org/soumission/papers/render/pdf/51.pdf|Le farming dans DokuWiki, intérêt et mise en œuvre}}.
-For people who can read French, here is my article from JRES2009 about this technique and plugin : [[https://2009.jres.org/soumission/papers/render/pdf/51.pdf]].
 The best way to understand what it deals with is to try it.
@@ Line 41: / Line 53: @@
 You'd better install it in a new wiki with no content as it speeds up setup and as reverting from farm transformation isn't easy. **This does not mean you will lose data; the plugin will just move your DokuWiki install.**
-==== Examples : ====
+==== Examples ====
 Suppose you have a file system like this one:
   /var/www/doku (where your DokuWiki is installed)
-If you set farmfsroot to "/var/www/doku/", farmer to "main/" and barn to "wikis/" it will create the following structure:
+=== Example 1 ==
+If you set farmfsroot to ''/var/www/doku/'', farmer to ''main/'' and barn to ''wikis/'' it will create the following structure:
   /var/www/doku
   +- main (where are put all the files from your original DokuWiki)
   +- wikis (where will be put all the animals
-If you set farmfsroot to "/var/www/doku/", farmer to "main/" and barn to "" it creates:
+=== Example 2 ==
+If you set farmfsroot to ''/var/www/doku/'', farmer to ''main/'' and barn to "" it creates:
   /var/www/doku
   +- main (where are put all the files from your original DokuWiki)
-And will put all animals directly in "/var/www/doku/".
+And will put all animals directly in ''/var/www/doku/''.
-If you set farmfsroot to "/var/www/", farmer to "doku/" and barn to "" it creates:
+=== Example 3 ==
+If you set farmfsroot to ''/var/www/'', farmer to ''doku/'' and barn to "" it creates:
   /var/www/
   +- doku (your original setup remains here, farm just adds its utilities)
-All animals will be put in "/var/www/"
+All animals will be put in ''/var/www/''
+==== ====
-If the directory pointed by farmfsroot/barn exists and already contains folders (like animals from another farming system, farm1 or farm2 ...) the setup script will ask you whether you want to convert some to the new system, leaving the other untouched.
+If the directory pointed by ''farmfsroot/barn'' exists and already contains folders (like animals from another farming system, farm1 or farm2 ...) the setup script will ask you whether you want to convert some to the new system, leaving the other untouched.
 **For now the plugin can only work with userewrite parameter set IN THE FARM CONFIG (the farmer/animals can have userewrite = 0).**
@@ Line 74: / Line 94: @@
   * Looks like if using a wiki with no rewrite at all things are a bit dull, still investigating that ... Stay tuned!
-  * If you put the {ANIMAL} tag in any file (conf / pages ...) of an animal and then use it as template the tag will be replaced by the new animal's name
+  * If you put the ''{ANIMAL}'' tag in any file (conf / pages ...) of an animal and then use it as template the tag will be replaced by the new animal's name
-  * DOKU_FARM_ANIMAL and DOKU_IS_FARMER are defined by the pre-loaded script, they can be used in other plugins / template or even config files!
+  * ''DOKU_FARM_ANIMAL'' and ''DOKU_IS_FARMER'' are defined by the pre-loaded script, they can be used in other plugins / template or even config files!
 ===== Todo =====
@@ Line 129: / Line 149: @@
 Schplurtz on feb 1st 2010 :
-The pluginmanager **works** from within the farm. This is not desired and is a DokuWiki bug that is already reported. You may [[http://bugs.splitbrain.org/index.php?do=details&task_id=1856&string=pluginmanager&project=1|vote for this task]], it may speed up the resolution...
+The pluginmanager **works** from within the farm. This is not desired and is a DokuWiki bug that is already reported. You may <del>[[http://bugs.dokuwiki.org/index.php?do=details&task_id=1856&string=pluginmanager&project=1|vote for this task]]</del>->Fixed, it may speed up the resolution...
 As a quick fix, edit DokuWiki file ''lib/plugins/plugin/admin.php'' and add ''if( $this->disabled ) return;'' to functions handle and function html, like this :
@@ Line 152: / Line 172: @@
   - the French translation of ''$lang['config_deletewsdl_failure']'' in fr/lang.php is wrong ;
   - the farm messages (''message_*'' in fr/lang.php) seem to appear in English although the wiki farm is in French (in my case) ;
-  - (when farmer wiki use URL rewriting and [[http://www.dokuwiki.org/config:useslash|useslash]] is true, images (icons) in farm admin are not displayed when we admin the farm from a page into a namespace. //-> to check//)
+  - (when farmer wiki use URL rewriting and [[config:useslash|useslash]] is true, images (icons) in farm admin are not displayed when we admin the farm from a page into a namespace. //-> to check//)
 Good night and congratulation for your work! --- //Floriang, 2010-03-03 00:30 ://
@@ Line 286: / Line 306: @@
 Hi, I get the same error as Javier and Steve. I use FreeBSD and I have set the permissions so that the whole DokuWiki directory is owned by Apache. This is a "try only" fresh DokuWiki install, with no URL rewriting by default, but I have also tried with internal rewriting turned on. I will try to install all the stuff by hand. Am I missing anything obvious? Thanks.
+> //Benat, 01/12/2010//
+>
+> Setting up the farm by hand as explained [[tips:farm|here]] worked without any problems, but I had some time today so I decided to give the plugin a new try.
+>
+> For some odd reason the install script fails at creating the "installed" file : <code>if(!@touch(DOKU_FARM_PLUGIN.'installed', 'w'))</code> (install.class.php, line 112). The permissions are correctly set though. I have touched the file manually and I can see the farm management interface. I will investigate further.
+//RemyA, 01/16/2011//
+The problem above comes from the use of the second parameter for the touch function. Remove that parameter and it will work.
 ----
@@ Line 332: / Line 362: @@
 > It seems that theres sth. wrong with your file permissions? Please check if the webserver has access to /home/erpwiki/www/ and /home/erpwiki/www/farmstructurecreator.php  --- [[user>lupo49]] //2010/11/27 23:47//
+=== Typo in .htaccess file ===
+Hi. I'm not able (yet) to have this plugin work on ubuntu server lucid lynx apache 2.2.14-5ubuntu8.4 with doku anteater, although I applied the correction indicated in this page. Anyway, I found a typo in file ''lib/plugins/farm/install/barn.htaccess''
+First line reads
+<code>
+Option -Indexes
+</code>
+while it should read (notice the final **s**)
+<code>
+Options -Indexes
+</code>
+=== Dokuwiki Admin is empty after the installation  ===
+Hi! I installed your plugin and now I cannot access the Admin-Area anymore. When I click on "Admin" on top of the wiki, I get a blank page. So I cannot uninstall the plugin anymore and am afraid of having killed my Dokuwiki-installation..