Share pages

With PageSync you can also select pages or files and create a '''PageSync Share File''' from them.

A '''PageSync share file''' can be used on another Wiki with PageSync installed and have those pages or files be installed there.

The big difference with the Backup option is that you can choose what pages or files will be included based on tags. Also restoring a backup on another Wiki will add the contents to PageSync to monitor them as well. Restoring a '''PageSync Share''' option only adds the pages or files to a wiki once. Therefore a '''PageSync share file''' could be used to install a set of templates, widgets, pages and files to add functionality to your wiki.

If you navigate to the PageSync Special page and click on the SHARE tab you will see an overview of the shared files you have created if you already have any.

This page allows for you to download a PageSync Share file or delete it from your server. There are also two button to create a new PageSync Share file or install a PageSync Share file.

[[File:Screenshot PageSync Share page.png|alt=Screenshot PageSync Share page|none|thumb|600x600px|PageSync Share page]]

<hr>
==== Install a PageSync Shared File ====
[[File:Screenshot_PageSync_Install_PageSync_Share_file_screen_v2-1.png|alt=Install PageSync Share file screen|thumb|600x600px|Install PageSync Share file screen]]



Installing a set of pages through a '''PageSync Share file''' is done by selecting a Shared file from the list. This list is maintained on the Github PageSync shared repository.


Choose one of the available '''PageSync Shared files''' click the download and preview button, PageSync will check if the file is valid and will take you to the next page where you can view details information on the '''PageSync Share File'''.



[[File:Screenshot PageSync preview ShareFile install.png|alt=Information on the PageSync Share file you are about to install.|left|thumb|600x600px|Information on the PageSync Share file you are about to install.]]



The Preview page will show you all the information available before installing the '''PageSync Share File'''. You also need to agree with the description within the File information.

Once you click the '''INSTALL FILES''' button, PageSync will install all the pages and files that are in the ZIP file.

'''Note:''' You can install any compatible '''PageSync Shared File''' from e.g. github by URL when using the Maintenance script. Making it very flexible to install from any source and not just the PageSync Share Repo.












<hr>
==== Create a PageSync Share File ====
[[File:Screenshot PageSync create PageSync Share File.png|alt=Screenshot PageSync create PageSync Share File|thumb|600x600px|PageSync create PageSync Share File]]

If you click the create the button create a share ZIP file, you will get a new screen where you select pages or files based on their tags.

You have three options there..

* Pages must have all chosen tags
* Pages must have at least one chosen tag
* Ignore tags and select all synced pages








[[File:Screenshot PageSync create share file overview.png|alt=Screenshot PageSync create share file overview|left|thumb|600x600px|PageSync create share file overview]]





After clicking the '''Select and preview pages'''-button you will get an overview of the selected pages and files.

You will also '''need''' to add a Description/Disclaimer to the to be created Share File.

Project, Company, Requirements and Name are optional. Requirements are used to specify what extensions are needed or any other requirement. Requirements are added as "MediaWiki:v1.35x;PageSync:v2.1". Versions are optional. Another example : "MediaWiki:v1.28+;FlexForm".
PageSync will always add your name and the name of the Wiki where you are creating the '''PageSync Share file''' from.

This information will be shown when someone wants to install you PageSync Share File.

Once you click on the '''Create share file'''-button, you will go back to the main PageSync Share page with an overview of your '''PageSync Share Files'''.