Publishing large sections and sites

November 14, 2023

The Site Settings - Publication module offers an easier way of publishing large sites or sections of site. The current publication editing interfaces are not well suited for such large publications as they retrieves information of all the content and nodes to be published. This takes a long time and can result in a session timeout. Furthermore, this level of details is not needed for large publications.

Ask your administrator to enable it on your site: A new Site publication entry appears in jContent>Additional.

How to use it

Permissions

User with the following permissions will be able to use this publication panel:

  • the “Publish” permission on the site and
  • the “Site admin publication”: this new permission is added by default to the Site administrator role

How to publish a site with this panel?

The Site publication panel looks like:

site-settingq-pub-1.png

In order to execute a publication, you need to first select the scope of the publication:

  • Current site: it will publish all the site
  • All under the following node: you need to type the path of the section you want to publish. Everything under the node will be published.

You need then to select the publication languages. The form displays all the languages enabled on the site. You can select one or several languages.

Once the scope and the languages selected, a confirmation window is displayed:

site-settings-pub-2.png

The publication jobs (one per language) will be scheduled once you have clicked on the “Publish” button. Note that only one job can be executed at a time, the other publications being queued. You can see the status of the publications started/executed using the Site publication panel by clicking on the “Show last publication status” button. In our example, the publication in French will start once the publication in English has finished.

site-settings-pub-3.png

How to know the status of the publications?

You can use the previous screen  “Show last publication status” to see the results of the previously started publications:

site-settings-pub-4.png

The table shows information if the publication was not executed:

  • the contents were already published
  • an issue happened: in such case, an information message is available when clicking on the “Show details” button:

site-settings-pub-5.png

Note that the information displayed here come from the publication jobs themselves.

Email notification

If the email notifications are set on the server, then the user who started a publication using the Site setting publication module will receive an email notifying him on the status of the publication:

  • Publication was successful
  • Nothing to publish
  • Publication was not executed