Skip to content
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

References (not just links) to item (view and menu item) – Update to released plone.restapi.relations #4842

Merged
merged 15 commits into from
Jun 14, 2023
Merged
Show file tree
Hide file tree
Changes from 8 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
Binary file modified docs/source/_static/user-manual/manage/link-to-items.png
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would it be possible to reduce the image width by resizing the browser width for legibility? Images should be no wider than 740 pixels to fit within the documentation's main view port.

https://6.docs.plone.org/contributing/documentation/authors.html#plone-documentation-styleguide

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Of course, thanks for the hint. Changed in c4106b0

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
14 changes: 7 additions & 7 deletions docs/source/user-manual/links-to-item.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,22 @@
---
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"
---

(links-to-item-label)=

# Finding links to the current item
# Finding links and relations to the current item

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.

```{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
Expand All @@ -27,7 +27,7 @@ Click then on the item labeled {guilabel}`Links to item`.
You can see now a table displaying all links to 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 "Links to My Summer Vacation - Day 2". A table with two columns (first column labeled with "Linking 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.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This summarizes the language that I would like to see used and adapted in the code for the panel. I probably missed exactly where the updates would be necessary in the code.

I think the row Content that link to this item can be merged with the heading above the table, into Content that links to {ITEM_NAME}.

Suggested change
:alt: A panel captioned with "Links to My Summer Vacation - Day 2". A table with two columns (first column labeled with "Linking 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 with the heading "Content that links to {ITEM_NAME}", followed by a table describing the content.
The table has sections that show the content is linked by either a hyperlink or a reference.
The first column is labeled "LINKED BY HYPERLINK" or "LINKED BY REFERENCE '{REF_NAME}'".
The second and third columns are labeled "REVIEW STATE" and "TYPE".

```

For editors, this view gives insight to whether those links are still relevant.
Expand Down
34 changes: 34 additions & 0 deletions locales/ca/LC_MESSAGES/volto.po
Original file line number Diff line number Diff line change
Expand Up @@ -425,6 +425,7 @@ msgstr ""
#: components/manage/Controlpanels/UpgradeControlPanel
#: components/manage/Diff/Diff
#: components/manage/History/History
#: components/manage/LinksToItem/LinksToItem
#: components/manage/Multilingual/ManageTranslations
#: components/manage/Preferences/ChangePassword
#: components/manage/Preferences/PersonalPreferences
Expand Down Expand Up @@ -744,6 +745,11 @@ msgstr ""
msgid "Content rules from parent folders"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Content that link to this item
msgid "Content that link to this item"
msgstr ""

#: components/manage/Controlpanels/ContentTypes
# defaultMessage: Content type created
msgid "Content type created"
Expand Down Expand Up @@ -1913,6 +1919,22 @@ msgstr "Enllaç a"
msgid "Link translation for"
msgstr "Traducció d'enllaços per"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Linking this item with
msgid "Linking this item with"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
#: components/manage/Toolbar/More
# defaultMessage: Links To Item
msgid "Links To Item"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Links to {title}
msgid "Links to {title}"
msgstr ""

#: components/manage/Blocks/Listing/schema
# defaultMessage: Listing
msgid "Listing"
Expand Down Expand Up @@ -2241,6 +2263,11 @@ msgstr "No s'han trobat articles en aquest contenidor."
msgid "No items selected"
msgstr "No s'ha seleccionat cap element"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: No links to this item found.
msgid "No links to this item found."
msgstr ""

#: components/manage/Blocks/Maps/MapsSidebar
# defaultMessage: No map selected
msgid "No map selected"
Expand Down Expand Up @@ -2783,6 +2810,7 @@ msgid "Revert to this revision"
msgstr "Torna a aquesta revisió"

#: components/manage/Contents/Contents
#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Review state
msgid "Review state"
msgstr "Estat de revisió"
Expand Down Expand Up @@ -3655,6 +3683,7 @@ msgid "Triggering event field error. Please select a value"
msgstr ""

#: components/manage/Controlpanels/ContentTypes
#: components/manage/LinksToItem/LinksToItem
#: components/manage/Widgets/SchemaWidget
#: components/theme/View/TabularView
# defaultMessage: Type
Expand Down Expand Up @@ -4298,6 +4327,11 @@ msgstr "Heroi"
msgid "html"
msgstr "HTML"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: hyperlink
msgid "hyperlink"
msgstr ""

#: config/Blocks
# defaultMessage: Image
msgid "image"
Expand Down
34 changes: 34 additions & 0 deletions locales/de/LC_MESSAGES/volto.po
Original file line number Diff line number Diff line change
Expand Up @@ -422,6 +422,7 @@ msgstr "Verfügbare Inhaltsregeln:"
#: components/manage/Controlpanels/UpgradeControlPanel
#: components/manage/Diff/Diff
#: components/manage/History/History
#: components/manage/LinksToItem/LinksToItem
#: components/manage/Multilingual/ManageTranslations
#: components/manage/Preferences/ChangePassword
#: components/manage/Preferences/PersonalPreferences
Expand Down Expand Up @@ -741,6 +742,11 @@ msgstr "Inhaltsregeln für {title}"
msgid "Content rules from parent folders"
msgstr "Inhaltsregeln von übergeordneten Seiten"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Content that link to this item
msgid "Content that link to this item"
msgstr "Alle Inhalte, die auf dieses Item verlinken"

#: components/manage/Controlpanels/ContentTypes
# defaultMessage: Content type created
msgid "Content type created"
Expand Down Expand Up @@ -1910,6 +1916,22 @@ msgstr "Link auf"
msgid "Link translation for"
msgstr "Übersetzung verbinden"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Linking this item with
msgid "Linking this item with"
msgstr "Inhalte, die hierher verlinken"

#: components/manage/LinksToItem/LinksToItem
#: components/manage/Toolbar/More
# defaultMessage: Links To Item
msgid "Links To Item"
msgstr "Verlinkende Inhalte"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Links to {title}
msgid "Links to {title}"
msgstr "Zu {title} verlinkende Inhalte"

#: components/manage/Blocks/Listing/schema
# defaultMessage: Listing
msgid "Listing"
Expand Down Expand Up @@ -2238,6 +2260,11 @@ msgstr "Keine Elemente gefunden"
msgid "No items selected"
msgstr "Kein Element ausgewählt"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: No links to this item found.
msgid "No links to this item found."
msgstr "Keine Links gefunden."

#: components/manage/Blocks/Maps/MapsSidebar
# defaultMessage: No map selected
msgid "No map selected"
Expand Down Expand Up @@ -2780,6 +2807,7 @@ msgid "Revert to this revision"
msgstr "Die aktuelle Version durch diese ersetzen"

#: components/manage/Contents/Contents
#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Review state
msgid "Review state"
msgstr "Arbeitsablauf"
Expand Down Expand Up @@ -3652,6 +3680,7 @@ msgid "Triggering event field error. Please select a value"
msgstr "Fehler im auslösenden Ereignis. Bitte geben Sie einen Wert ein"

#: components/manage/Controlpanels/ContentTypes
#: components/manage/LinksToItem/LinksToItem
#: components/manage/Widgets/SchemaWidget
#: components/theme/View/TabularView
# defaultMessage: Type
Expand Down Expand Up @@ -4295,6 +4324,11 @@ msgstr "Hero"
msgid "html"
msgstr "HTML"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: hyperlink
msgid "hyperlink"
msgstr ""

#: config/Blocks
# defaultMessage: Image
msgid "image"
Expand Down
34 changes: 34 additions & 0 deletions locales/en/LC_MESSAGES/volto.po
Original file line number Diff line number Diff line change
Expand Up @@ -416,6 +416,7 @@ msgstr ""
#: components/manage/Controlpanels/UpgradeControlPanel
#: components/manage/Diff/Diff
#: components/manage/History/History
#: components/manage/LinksToItem/LinksToItem
#: components/manage/Multilingual/ManageTranslations
#: components/manage/Preferences/ChangePassword
#: components/manage/Preferences/PersonalPreferences
Expand Down Expand Up @@ -735,6 +736,11 @@ msgstr ""
msgid "Content rules from parent folders"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Content that link to this item
msgid "Content that link to this item"
msgstr ""

#: components/manage/Controlpanels/ContentTypes
# defaultMessage: Content type created
msgid "Content type created"
Expand Down Expand Up @@ -1904,6 +1910,22 @@ msgstr ""
msgid "Link translation for"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Linking this item with
msgid "Linking this item with"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
#: components/manage/Toolbar/More
# defaultMessage: Links To Item
msgid "Links To Item"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Links to {title}
msgid "Links to {title}"
msgstr ""

#: components/manage/Blocks/Listing/schema
# defaultMessage: Listing
msgid "Listing"
Expand Down Expand Up @@ -2232,6 +2254,11 @@ msgstr ""
msgid "No items selected"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: No links to this item found.
msgid "No links to this item found."
msgstr ""

#: components/manage/Blocks/Maps/MapsSidebar
# defaultMessage: No map selected
msgid "No map selected"
Expand Down Expand Up @@ -2774,6 +2801,7 @@ msgid "Revert to this revision"
msgstr ""

#: components/manage/Contents/Contents
#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Review state
msgid "Review state"
msgstr ""
Expand Down Expand Up @@ -3646,6 +3674,7 @@ msgid "Triggering event field error. Please select a value"
msgstr ""

#: components/manage/Controlpanels/ContentTypes
#: components/manage/LinksToItem/LinksToItem
#: components/manage/Widgets/SchemaWidget
#: components/theme/View/TabularView
# defaultMessage: Type
Expand Down Expand Up @@ -4289,6 +4318,11 @@ msgstr ""
msgid "html"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: hyperlink
msgid "hyperlink"
msgstr ""

#: config/Blocks
# defaultMessage: Image
msgid "image"
Expand Down
34 changes: 34 additions & 0 deletions locales/es/LC_MESSAGES/volto.po
Original file line number Diff line number Diff line change
Expand Up @@ -427,6 +427,7 @@ msgstr "Reglas de contenido disponibles:"
#: components/manage/Controlpanels/UpgradeControlPanel
#: components/manage/Diff/Diff
#: components/manage/History/History
#: components/manage/LinksToItem/LinksToItem
#: components/manage/Multilingual/ManageTranslations
#: components/manage/Preferences/ChangePassword
#: components/manage/Preferences/PersonalPreferences
Expand Down Expand Up @@ -746,6 +747,11 @@ msgstr "Reglas de contenido para {title}"
msgid "Content rules from parent folders"
msgstr "Reglas de contenido de las carpetas principales"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Content that link to this item
msgid "Content that link to this item"
msgstr ""

#: components/manage/Controlpanels/ContentTypes
# defaultMessage: Content type created
msgid "Content type created"
Expand Down Expand Up @@ -1915,6 +1921,22 @@ msgstr "Enlazar a"
msgid "Link translation for"
msgstr "Enlazar traducción de"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Linking this item with
msgid "Linking this item with"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
#: components/manage/Toolbar/More
# defaultMessage: Links To Item
msgid "Links To Item"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Links to {title}
msgid "Links to {title}"
msgstr ""

#: components/manage/Blocks/Listing/schema
# defaultMessage: Listing
msgid "Listing"
Expand Down Expand Up @@ -2243,6 +2265,11 @@ msgstr "No hay elementos en esta carpeta."
msgid "No items selected"
msgstr "No se han seleccionado elementos"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: No links to this item found.
msgid "No links to this item found."
msgstr ""

#: components/manage/Blocks/Maps/MapsSidebar
# defaultMessage: No map selected
msgid "No map selected"
Expand Down Expand Up @@ -2785,6 +2812,7 @@ msgid "Revert to this revision"
msgstr "Revertir a esta revisión"

#: components/manage/Contents/Contents
#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Review state
msgid "Review state"
msgstr "Estado"
Expand Down Expand Up @@ -3657,6 +3685,7 @@ msgid "Triggering event field error. Please select a value"
msgstr "Error de campo de evento desencadenante. Por favor seleccione un valor"

#: components/manage/Controlpanels/ContentTypes
#: components/manage/LinksToItem/LinksToItem
#: components/manage/Widgets/SchemaWidget
#: components/theme/View/TabularView
# defaultMessage: Type
Expand Down Expand Up @@ -4300,6 +4329,11 @@ msgstr "Héroe"
msgid "html"
msgstr "HTML"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: hyperlink
msgid "hyperlink"
msgstr ""

#: config/Blocks
# defaultMessage: Image
msgid "image"
Expand Down
Loading