-
-
Notifications
You must be signed in to change notification settings - Fork 612
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
References (not just links) to item (view and menu item) – Update to …
…released plone.restapi.relations (#4842) Co-authored-by: Steve Piercy <web@stevepiercy.com>
- Loading branch information
1 parent
74f9a6f
commit 7676a4b
Showing
27 changed files
with
689 additions
and
205 deletions.
There are no files selected for viewing
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,37 +1,37 @@ | ||
| --- | ||
| myst: | ||
| html_meta: | ||
| "description": "User manual on how to find all links to the current item." | ||
| "property=og:description": "User manual on how to find all links to the current item." | ||
| "property=og:title": "Finding links to the current item." | ||
| "keywords": "Volto, Plone, frontend, React, User manual, links" | ||
| "description": "User manual on how to find all links and relations to the current item." | ||
| "property=og:description": "User manual on how to find all links and relations to the current item." | ||
| "property=og:title": "Finding links and relations to the current item." | ||
| "keywords": "Volto, Plone, frontend, React, User manual, links, relations, references, related content" | ||
| --- | ||
|
|
||
| (links-to-item-label)= | ||
|
|
||
| # Finding links to the current item | ||
| # Finding links and references to the current page | ||
|
|
||
| Sometimes it can be hard to keep track from where a certain page is referenced. | ||
| This is especially true whenever you want to reconstruct your website with a greater number of objects being moved or deleted. | ||
| For this situation, you can visit the {guilabel}`Links to item` page, which is an overview of all objects that refererence a certain object. | ||
| For this situation, you can visit the {guilabel}`Links and references` page, which is an overview of all content items that reference a certain content item. | ||
|
|
||
| ```{note} | ||
| An item references another item by creating a hyperlink to this item, using the item in a block, or using it in the {guilabel}`Related Items` field. | ||
| An item references another item by creating a hyperlink to this item, using the item in a block, referencing it in the {guilabel}`Related Items` field, or referencing it in a relation field. | ||
| ``` | ||
|
|
||
| ## {guilabel}`Links to item` view | ||
| ## {guilabel}`Links and references` view | ||
|
|
||
| In the toolbar on the left side, you can click on the item with the three horizontally aligned dots, called {guilabel}`More menu`. | ||
| Click then on the item labeled {guilabel}`Links to item`. | ||
| Click then on the item labeled {guilabel}`Links and references`. | ||
|
|
||
| You can see now a table displaying all links to the current item. | ||
| You can see now a table displaying all links to and references of the current item. | ||
|
|
||
| ```{image} ../_static/user-manual/manage/link-to-items.png | ||
| :alt: A panel captioned with "Links to My Summer Vacation - Day 2". A table with two columns (first column labeled with "linked by this item", second column labeled with "review state"). In the row appears a link titled "Links to My Summer Vacation - Day 1", because it is referencing the current item. | ||
| :alt: A panel captioned with "Content that links to or references 'Supervisor Adélaïde Pickavance'". Below the caption, there is a table with one section per relation type, where each section has three columns. The first column's heading is the relation name, the second is "Review State", and the third is "Type". The sections are named, from top to bottom, "Linking this item with hyperlink in text", "Referencing the item as related item", and "Referencing this item with '[Name of Relation]'". | ||
| ``` | ||
|
|
||
| For editors, this view gives insight to whether those links are still relevant. | ||
| On second sight, it also helps to prevent potential broken links. | ||
| For editors, this view gives insight to whether those links and references are still relevant. | ||
| On second sight, it also helps to prevent potential broken links and relations. | ||
|
|
||
| For example, when you try to delete this page with other pages linking to it, you will get a warning that this will cause broken links that lead to a "not found" error page. | ||
| For example, when you try to delete this page with other pages linking to it, you will get a warning that this will cause broken links or relations that lead to a "not found" error page. | ||
| If you receive such a warning, you can inspect this view and go through each referencing page, removing any references. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.