Skip to content

#26559 add cascading publication info to Dashboard/Draft & Public seciton #332

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 19 additions & 4 deletions docs/panel/ContentObjects/draft-public.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ Below is a list of each status with a brief explanation:
- **Modified** – When a content object with the `public` status is edited, a new `modified` version is created, while the existing `public` version remains unchanged.
- **Archived** – Assigned to content that has been withdrawn from the Public state.

![cto-grid.png](../images/co-form/draftpublic/cto-grid.png){: .center .width75 .border}
![Content objects grid](../images/co-form/draftpublic/cto-grid.png){: .center .width75 .border}

!!! Note
**In the Dashboard, all content types will be visible** regardless of their status, unlike in the API.
Expand All @@ -36,26 +36,41 @@ Below is a list of each status with a brief explanation:
To make an object that satisfies all requirements available to all users, it must be made public.
This can be achieved by clicking the green **Publish** button located in the toolbar.

![publish-draft.png](../images/co-form/draftpublic/publish-draft.png){: .center .width75 .border}
![Publishing object](../images/co-form/draftpublic/publish-draft.png){: .center .width75 .border}

!!! Note
Now object will have the status `public` and will be visible, by default in the [listing API](/docs/API/draft-public/draft-public).

#### Cascading publication

When a Content Object is linked to others using Draft & Public mode, publishing actions can influence linked objects.
When initiating the publishing process for such content, a confirmation modal will appear to guide the action. This modal presents two options:

* **Publish both the object and related objects** – Choosing this option will simultaneously publish the primary content object as well as all linked objects.
* **Publish the selected object only** – This option restricts the publishing action to the chosen object, leaving all associated linked objects unaffected.

![Cascading publication](../images/co-form/draftpublic/cascade-publish.png){: .center .width75 .border}

If the confirmation modal is **closed without making a selection**, no publication action will take place, and the current statuses of all objects will remain unchanged.

The modal appears when publishing an object and has linked objects in states other than public.

### Unpublishing content

If you wish to revert the public version to a draft to make some adjustments,
you can use the **Unpublish** button located in the Extras menu.

![unpublishing.png](../images/co-form/draftpublic/unpublishing.png){: .center .width75 .border}
![Unpublishing object](../images/co-form/draftpublic/unpublishing.png){: .center .width75 .border}

!!! Note
Now object will be reverted from `public` state into the `draft` and will not be visible, by default in the [listing API](/docs/API/draft-public/draft-public).

### Archiving content

If you wish to archive the public version, withdrawing it from the public state and marking it as archived,
you can use the **Archive** button located in the Extras menu.

![archive.png](../images/co-form/draftpublic/archive.png){: .center .width75 .border}
![Archiving object](../images/co-form/draftpublic/archive.png){: .center .width75 .border}

!!! Note
Now object will have the status `archive` and will not be visible, by default in the [listing API](/docs/API/draft-public/draft-public).
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.