Differences

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

--- plugin:move [2016-08-12 14:27] – 81.82.205.48
+++ plugin:move [2024-03-22 12:20] (current) – [Move Plugin] Compatible: +Kaos mopani
@@ Line 6: / Line 6: @@
 email      : michael@content-space.de
 type       : admin, action, helper
-lastupdate : 2015-10-18
+lastupdate : 2022-01-23
-compatible : Hrun, Detritus, "Elenor Of Tsort"
+compatible : Greebo, Hogfather, Igor, Jack Jackrum, Kaos
 depends    :
 conflicts  : autolink2
@@ Line 33: / Line 33: @@
 **Warning**: This plugin does not update ACL rules. For example if you had an ACL rule that read-protected a certain wiki page this rule won't have any effect anymore after moving that page.
-Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the plugin. 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.
-:!: **When updating an existing installation of this plugin it might be necessary to de-install the old plugin version first and re-install the new version thereafter.** Severe problems (e.g. inconsistent application menues with the old plugin screen combined with several unlogical [admin] buttons) have been observed after upating the plugin. For instance when originally installed on Dokuwiki release //2014-09-29 "Hrun"// and updated onto Dokuwiki release //2015-08-10 "Detritus"//.
+:!: **When updating an existing installation of this plugin in DokuWiki versions older than Release Summer 2015 "Detritus" it might be necessary to de-install the old plugin version first and re-install the new version thereafter.** Severe problems (e.g. inconsistent application menues with the old plugin screen combined with several unlogical [admin] buttons) have been observed after upating the plugin. For instance when originally installed on Dokuwiki release //2014-09-29 "Hrun"// and updated onto Dokuwiki release //2015-08-10 "Detritus"//.
+If, for any reason, you used an FTP client to upload pages, you should "hit" (open) them in a browser to be sure the index is refreshed, otherwise the move plugins will fail to work on the page, or worse, forget to update link on those page.
 ===== Usage =====
@@ Line 52: / Line 53: @@
 ==== Tree based move ====
-To plan more complicated restructuring of your wiki, the move plugin comes with a tree-based Move Manager. Open it by clicking on the link in the screen above.
+To plan more complicated restructuring of your wiki, the move plugin comes with a tree-based Move Manager. Open it by clicking on the link in the Move screen, pictured above.
-{{plugin:move-manager.png |Screenshot}}
+{{https://cloud.githubusercontent.com/assets/86426/2829055/2e6d9ba2-cf9e-11e3-8e8c-f8f43fff468f.png |Screenshot}}
-The Move Manager allows you to plan all moves and renames to be executed by drag'n'drop operations. Simply move pages, media files and namespaces to their desired locations until the tree represents the new layout you want to have.
+The Move Manager allows you to plan all moves and renames to be executed by drag'n'drop operations. Simply move pages, media files and namespaces to their desired locations until the tree represents the new layout you want to have. Starting from version 2017-01-07, multiple pages, media files or namespaces can be selected using checkboxes. When one of the selected items is moved, all selected items are moved to the target. The move fails (i.e., nothing is changed) if any of the selected items cannot be moved to the target (due to a naming conflict).
-One thing you cannot do with this method is to create a new namespace. If you need to do that, use the other interface to move one page or namespace to the new namespace. After that, the new namespace will appear in this interface so you can move everything else to it.
+As of version 2017-01-07, new namespaces can be created by clicking on the "+"-icon next to the root namespace. Newly created namespaces can then be moved to the desired target location and can also be renamed. Note that only namespaces which contain a page, media file or (non-empty) namespace will be saved.
-  * FIXME Please add some comments about how to activate and use the Move Manager
-  * FIXME the screenshot (move-manager.png) is not working
 ==== Simple Page Rename ====
 {{https://cloud.githubusercontent.com/assets/86426/2829067/4b7ad5a2-cf9e-11e3-98e8-f6de80ac7277.png?150 |Screenshot}}
-This feature is available to users and groups that have been configured through the ''allowrename'' option in the config manager. It is automatically available on all templates that implement the ''TEMPLATE_PAGETOOLS_DISPLAY'' event. \\
+This feature is available to users and groups that have been configured through the ''allowrename'' option in the config manager. It is automatically available on all templates that implement the ''TEMPLATE_PAGETOOLS_DISPLAY'' event and can be disabled in the config manager.
-Actually it is defined in source code and only available for the templates ''dokuwiki'', ''arago'' and ''bootstrap3'' (''action/rename.php'' line 45).
 Users can simply rename (or move) the page they are currently on.
 {{https://cloud.githubusercontent.com/assets/86426/2829070/4ec6c932-cf9e-11e3-8583-b046bd45c081.png?250| Screenshot}}
 ===== Support for other plugins =====
@@ Line 80: / Line 77: @@
   * [[include]]
   * [[struct]]
+  * [[combo]]
 Plugins not explicitly stating their compatibility are most probably not adjusted.
 ==== For plugin authors ====
@@ Line 118: / Line 117: @@
 Feel free to open a bug report if your plugin needs additional support from the move plugin.
+===== Technical Background =====
+The move plugin uses the search index of DokuWiki to find pages that contain links to moved pages or media files and then uses DokuWiki's parser to identify all links to pages or media files in the affected pages and changes them if necessary. Whenever a page is modified, a new revision of the page is created (but changes are batched, so when you move many pages e.g. using the tree-based move manager you should still only see 1-2 new revisions per affected page).
+In contrast to a simple search and replace this can identify much more complex situations e.g. when a link is %%[[Foo Bar]]%% it will be found if the page foo_bar is moved and using DokuWiki's parser makes sure that e.g. code blocks or special plugin syntax is not modified.
+Plugins can also add support, so e.g. the syntax of the include plugin will also be adjusted accordingly.
+When using the admin interface to move whole namespaces or multiple pages and media files, an option to show a preview of the changes is available. You are encouraged to have a look at the preview to check that the plugin will do what you intended. Changes to individual pages can be easily reverted later using the builtin revert functionality of DokuWiki.
+Both pages and media files have a list of revisions and saved, old versions in attic/media_attic respectively. These files need to be moved, too. Pages also have other metadata. Further, the search index needs to be adjusted (e.g. by re-indexing the page at the new location). The move plugin takes care of all that when you rename or move a page or media file.
+Depending on the plugins you are using there might be additional data to be moved. Plugins can add support for moving their data when a page is moved using the move plugin, e.g. the struct plugin adapts its database when a page is moved.
+The plugin moves old revisions together with the page (and a new revision reflecting the move is added). In the recent changes, two changes are added, documenting both the deletion at the old name and the creation at the new name. As only one change per page is displayed in the recent changes, this means that older changes of the page won't be displayed in the recent changes, but can be seen on the page's individual "old revisions" view.
+===== Troubleshooting =====
+  * [[https://forum.dokuwiki.org/d/20927/6|Forum: DokuWiki repeatedly replaces text of internal link]] (solved)
 ===== Issues and feature requests =====
 Please report bugs and feature requests in the [[https://github.com/michitux/dokuwiki-plugin-move/issues|issue tracker]].