No edit summary Tag: 2017 source edit |
No edit summary |
||
Line 45: | Line 45: | ||
All transferred pages and files continue to exist in the source wiki. They have to be deleted manually, if they are no longer nedded there. | All transferred pages and files continue to exist in the source wiki. They have to be deleted manually, if they are no longer nedded there. | ||
==Merging pages | ==Merging pages == | ||
For existing pages or wiki items (template, category, file), the changes are done. The changes consist in merging line by line after interactive selection by the user. A new wiki item is set in “pending” status. The new item is then marked as “draft”. | === Merge new pages and elements === | ||
Tranfered pages and elements are released automatically and instantly available in the target wiki. | |||
However, it is possible to configure in the server configuration whether the pages and elements first land in a specific draft namespace and have to be checked and released manually. | |||
If this is configured, the corresponding documentation is available on the [[Manual:Extension/MergeArticles|manual page of the MergeArticles extension]]. | |||
=== Merging pages with approval feature === | |||
If a page is transferred to a namespace with approval mechanism activated, [[Manual:Extension/ContentStabilization|the new version must be approved]] by a user with approval rights. | |||
For existing pages or wiki items (template, category, file), the changes are done. The changes consist in merging line by line after interactive selection by the user. A new wiki item is set in “pending” status. The new item is then marked as “draft”. | |||
*All „pending“ pages are listed on a special page ''Unreviewed pages''., | *All „pending“ pages are listed on a special page ''Unreviewed pages''., |
Latest revision as of 13:30, 4 April 2025
The functionality "Push & Merge" for WikiFarm copies the content of wiki pages to new or already existing pages in a different wiki of the same farm. In case of existing content, the merge mechanism asks the user to decide whether to keep or overwrite this content.
Selecting source files
At least two wikis in the same farm are required (source wiki and target wiki). The content transfer is initiated with the special page Special:ContentTransfer
in the source wiki. A user needs the necessary "push" rights to use this page.

Selection of target wiki and source content
- Receiving: Selection of the wiki, to which the content will be copied. The target wiki is always in the same wiki farm as the source wiki.
- Include related: Content that is linked from the selected pages (linked pages, files, templates) can be included in the transfer or excluded if this option is deselected.
Filter options
The following search filter options can be used to retrieve a list of transfer candidates in the source wiki:
- Modified since: shows only pages that have been modified since a selected date regardless of the last transfer.
- Modified since last transfer: shows only pages that have been change since their last transfer to the selected target. This will also affect included ressources.
- Page name: filters the source pages based on naming pattern.
- Namespace: shows pages from a particular namespace.
- Category: shows pages from a particular category.
- Only modified pages: shows only pages that have been change since their last push to the selected target.
- Select all/select none: the shown pages from the filtered lilst can be completely selected or deselected for the push.
Starting the transfer
Clicking the button Transfer initiates the transfer mechanism.
- Maximum number of transferred pages: The maximum number of pages is 200 per transfer. If you want to copy more than that, the pages have to be copied in multiple transfers.
- Non-existing namespace (target wiki): If the namespace of the selected pages does not exist in the target wiki, the user is notified that the namepsace has to be created in the target wiki in advance.
Pushing the pages
After selecting Push, the files are copied over to the target wiki. The following files are included, if applicable:
- the selected pages and the following associated pages and files:
- Category pages
- Books
- Templates
- Files
Protected pages: If a page cannot be copied - for example, because a draft page is protected during a review workflow - you will be notified accordingly. You can decide whether you want to overwrite the page anyway or skip it.
After the selection of pages from the source wiki is complete, a new dialog window for the transfer opens. It contaisn the path to the target wiki and a list of all pages that will be copied.
In this window, you can also see the transfer progress as well as a final transfer report.
All transferred pages and files continue to exist in the source wiki. They have to be deleted manually, if they are no longer nedded there.
Merging pages
Merge new pages and elements
Tranfered pages and elements are released automatically and instantly available in the target wiki.
However, it is possible to configure in the server configuration whether the pages and elements first land in a specific draft namespace and have to be checked and released manually.
If this is configured, the corresponding documentation is available on the manual page of the MergeArticles extension.
Merging pages with approval feature
If a page is transferred to a namespace with approval mechanism activated, the new version must be approved by a user with approval rights.
For existing pages or wiki items (template, category, file), the changes are done. The changes consist in merging line by line after interactive selection by the user. A new wiki item is set in “pending” status. The new item is then marked as “draft”.
- All „pending“ pages are listed on a special page Unreviewed pages.,
- From this special page, the user can browse to these pages, check the differences and approve each page after editing the draft version.
Wiki admins or editors can be notified about new pendings in e-mail.
Related info