plugin:move
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
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 | email : michael@content-space.de | ||
type : admin, action, helper | type : admin, action, helper | ||
- | lastupdate : 2015-10-18 | + | lastupdate : 2022-01-23 |
- | compatible : Hrun, Detritus, " | + | compatible : Greebo, Hogfather, Igor, Jack Jackrum, Kaos |
depends | depends | ||
conflicts | conflicts | ||
Line 33: | Line 33: | ||
**Warning**: | **Warning**: | ||
- | Install | + | Search and install |
- | :!: **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 // | + | :!: **When updating an existing installation of this plugin |
+ | If, for any reason, you used an FTP client to upload pages, you should " | ||
===== Usage ===== | ===== Usage ===== | ||
Line 52: | Line 53: | ||
==== Tree based move ==== | ==== 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 |
- | {{plugin:move-manager.png |Screenshot}} | + | {{https:// |
- | The Move Manager allows you to plan all moves and renames to be executed by drag' | + | The Move Manager allows you to plan all moves and renames to be executed by drag' |
- | 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, |
- | * 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 ==== | ==== Simple Page Rename ==== | ||
{{https:// | {{https:// | ||
- | This feature is available to users and groups that have been configured through the '' | + | This feature is available to users and groups that have been configured through the '' |
- | Actually it is defined | + | |
Users can simply rename (or move) the page they are currently on. | Users can simply rename (or move) the page they are currently on. | ||
{{https:// | {{https:// | ||
- | |||
===== Support for other plugins ===== | ===== Support for other plugins ===== | ||
Line 80: | Line 77: | ||
* [[include]] | * [[include]] | ||
* [[struct]] | * [[struct]] | ||
+ | * [[combo]] | ||
Plugins not explicitly stating their compatibility are most probably not adjusted. | Plugins not explicitly stating their compatibility are most probably not adjusted. | ||
+ | |||
==== For plugin authors ==== | ==== For plugin authors ==== | ||
Line 118: | Line 117: | ||
Feel free to open a bug report if your plugin needs additional support from the move plugin. | 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' | ||
+ | |||
+ | 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' | ||
+ | |||
+ | 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/ | ||
+ | |||
+ | 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" | ||
+ | |||
+ | ===== Troubleshooting ===== | ||
+ | |||
+ | * [[https:// | ||
===== Issues and feature requests ===== | ===== Issues and feature requests ===== | ||
Please report bugs and feature requests in the [[https:// | Please report bugs and feature requests in the [[https:// |
plugin/move.1471004874.txt.gz · Last modified: 2016-08-12 14:27 by 81.82.205.48