|
|
| (187 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) |
| Zeile 1: |
Zeile 1: |
| =Introduction=
| | '''Typo3/Workspaces''' - TYPO3-Arbeitsbereiche |
| *Workspaces in Typo3 allow you to create new versions of the website
| |
| *This tool is useful to create new versions before make them visible on the frontend
| |
| =Create a new Workspace=
| |
| *Enter in the root page of your website and create a new Workspace
| |
| [[Datei:Schermata 2021-02-24 alle 17.27.08.png|mini|ohne|New Workspace]]
| |
| *We will call it Version 3.0
| |
| *Set all the fields according to your needs
| |
| [[Datei:Schermata 2021-02-24 alle 17.28.58.png|mini|ohne|New Workspace]]
| |
| *Save>close
| |
| =The workspaces=
| |
| *You can switch between the different Workspaces (Versions) clicking the Workspaces icon
| |
| [[Datei:Schermata 2021-02-24 alle 17.33.05.png|mini|ohne|Workspaces icon]]
| |
| *The "Live Workspace" is the version of the website that is visible in the frontend
| |
| *You can select the version of the website you want to work on, in our case Version 3.0
| |
| *Once you are in the new Workspace you can add contents to the new version of the website
| |
| *The changes you will make in the new Workspace are not visible in the frontend
| |
| [[Datei:Schermata 2021-02-24 alle 17.36.56.png|mini|ohne|Add contents to the new Version]]
| |
| *The sections that are being modified in the new version are highlighted in the tree section
| |
| *Click on the View icon to check the new changes
| |
| [[Datei:Schermata 2021-02-24 alle 17.43.40.png|mini|ohne|View Icon]]
| |
| *Use the tool to see the differences between the 2 pages (1)
| |
| *If you are satisfied click on the button "Ready to publish" (2)
| |
| [[Datei:Schermata 2021-02-24 alle 17.48.15.png|mini|ohne|New version preview and "ready to publish" button]]
| |
| =Publish the changes=
| |
| *Enter in the Workspaces module of the new Workspace
| |
| *The highlighted pages are the ones that differ from the LIVE version of the website
| |
| [[Datei:Schermata 2021-02-24 alle 17.52.52.png|mini|ohne|New version]]
| |
| *You can see the changes that have be done for every page and set their status:
| |
| #Editing:The changes are not ready to be published. Someone is still working on them.
| |
| #Send to stage Ready to publish:The editor is satisfied of his work and is waiting for an approval
| |
| #Publish to LIVE: The changes will be published in the live Workspace
| |
| [[Datei:Schermata 2021-02-24 alle 17.55.23.png|mini|ohne|Different stages of publication]]
| |
|
| |
|
| | == Beschreibung == |
| | Funktionen der [[Typo3-Extension]] [[Typo3/Workspaces|Workspaces]] |
| | * Workspaces |
| | * Workflows |
| | * Arbeitsabläufe |
| | * Stufen |
| | * Versionierung |
| | * Bearbeitungs- und Veröffentlichungsprozess |
|
| |
|
| * This document explains how versioning and workspaces function in TYPO3 CMS and how they are set up.
| | == Überblick == |
| * The first part explains the technical background for administrators or developers who want to make their extensions version aware.
| | === Arbeitsbereich auswählen === |
| * The second part is for users of workspaces, a short guide about what is possible and how to use workspaces.
| | [[Image:WorkspaceMenu.png|mini|500px|Arbeitsbereichselektor in der oberen Leiste]] |
| * The last part shows how to create a custom workspace.
| | Auswahlfeld in der oberen rechten Ecke des Backends |
| | <br clear=all> |
| | ; Hinweis |
| | <blockquote> |
| | Wechsel des Arbeitsbereiches lädt das [[Typo3/Backend|Backend]] neu |
| | </blockquote> |
|
| |
|
| = Users Guide = | | === Arbeitsbereich-Anzeige === |
| *This section covers the workspace-related features in the backend.
| | ; Workspace-Indicator |
| *Most significantly workspaces have a selector box in the upper right corner of the backend.
| | [[Image:WorkspaceIndicator.png|mini|600px|Workspace indicator]] |
| [[File:WorkspaceMenu.png|none|The workspace selector in the top bar]] | |
|
| |
|
| *In this selector box you can choose between the workspaces available.
| | Zeigt Arbeitsbereich an |
| *The whole backend reloads each time one changes workspace.
| | * Farbänderung der oberen Leiste |
| *As a visual reminder that you are currently in a workspace, a section of the top bar changes to a different color: | |
| [[File:WorkspaceIndicator.png|none]]
| |
| Activation of a workspace highlighted in the top bar
| |
| As soon as you start editing inside a workspace, new versions get created for you.
| |
| A page which has a change in the current workspace is highlighted in the page tree:
| |
| [[File:ModifiedPageHighlight.png|none]]
| |
| Modified page highlighted in the page tree
| |
| The module '''WEB > Workspaces''' allows you to monitor changes in a workspace:
| |
| [[File:WorkspaceModuleOverview.png|none]]
| |
| An overview of the changes in the workspaces module
| |
| First of all you get an overview of all changes in the current workspace and the current page (or below, if so defined). This is also the control center for reviewing, editing and sending any change to another stage. All these operations are detailed below. The icons correspond to the following operations:# ''Show changes'': opens the detailed view
| |
| # ''Swap'': swaps the workspace and live version of that record
| |
| # ''Preview element'': opens the preview window
| |
| # ''Edit element'': edits the record
| |
| # ''Open version of page'': switches to the '''WEB > Page''' module
| |
| # ''Discard'': discards the change
| |
| # selects the record. Once a records is selected, the two action menus at the bottom left become active.
| |
|
| |
|
| The third menu at the bottom of the view is called the "mass action" menu ([https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#users-guide-mass-action detailed below]).
| | <br clear=all> |
| You can also switch workspace by clicking on the corresponding tab.
| |
| The detailed view opens in a popup with the full history information.
| |
| [[File:WorkspaceModuleChangeDetails.png|none]]
| |
| Viewing all details about a change
| |
| == Previewing content ==
| |
| When in a workspace, as soon as you hit the "View webpage" button or use the "Save and view page" action, you will access the workspace preview. This is also possible straight from the ''Workspaces'' module, when clicking on the "Preview element" button.
| |
| The workspaces preview is a simultaneous view of the live and workspace version. The default selection is to show the workspace version and to display a slider with which it is possible to change the display to the live version. With the select box in the upper right corner you can change the mode to - for example - vertical split:
| |
| [[File:WorkspaceSplitPreview.png|none]]
| |
| Changing the workspaces split preview
| |
| Clicking on the "List view" tab leads you to the same view as the ''Workspaces'' module.
| |
|
| |
|
| == Generating a preview link == | | === Geänderte Seite === |
| An additional feature of workspace is that a special preview link can be generated. It can be shared with anyone, even with people who have no access whatsoever to the TYPO3 CMS installation. With this link, people are able to view the page as it appears in the given workspace.
| | Seiten mit Änderungen werden im Seitenbaum hervorgehoben |
| Simply hit the "Generate page preview links" button in the docheader and copy the link from the popup window:
| | [[Image:ModifiedPageHighlight.png|mini|600px| Seiten "Open Source" hat Änderungen]] |
| [[File:PreviewLink.png|none]] | | <br clear=all> |
| The preview link appears in a popup window
| |
|
| |
|
| == Review process == | | == Kontrollzentrum == |
| Sending a change to another stage in the review process is achieved via the detailed view popup window:
| | ; WEB > Workspaces |
| [[File:SendToAnotherStage.png|none]]
| | Kontrollzentrum zum Überprüfen, Bearbeiten und Senden von Änderungen an eine andere Stufe |
| Sending a change to the previous or next stage
| |
| The change can either be sent to the next stage or sent back to the previous one. Once a stage has been selected, another popup window appears for entering a message:
| |
| [[File:SendToStageMessage.png|none]]
| |
| Adding a message upon sending to another stage
| |
| The messages are visible as comments in the change history.
| |
| Once the change reaches the "Ready to publish" stage, anyone with the proper rights can publish it to the LIVE version, upon which it is visible on the web site. Note that it is possible for anyone that is allowed to publish to directly publish from any stage. A change does therefore not necessary need to have been in all stages.
| |
| It is also possible to send a change to another stage by selecting it in the overview and using the menu at the bottom left:
| |
| [[File:IndividualActions.png|none]]
| |
| Sending one or more changes directly to some other stage
| |
|
| |
|
| == The mass action menu == | | === Überwachung von Änderungen === |
| *You can also publish, swap or discard a '''whole workspace''' at once with the third menu at the bottom.
| | ; Überblick über Änderungen im Arbeitsbereich |
| *This select box – called "Mass Actions" - is only active when no element is selected:
| | [[Image:WorkspaceModuleOverview.png|mini|700px|Überblick über Änderungen im Modul Arbeitsbereiche]] |
| [[File:MassActionsMenu.png|none]] | | * Aktuelle Seite |
| <div style="color:#ffffff;">Important</div>
| | * Unterseiten |
| <span style="background-color:#ebf6eb;">The mass actions affect the </span><span style="background-color:#ebf6eb;">'''whole workspace'''</span><span style="background-color:#ebf6eb;">, which means even the changes that may not currently be visible in the workspaces module because they are not within the currently selected branch in the page tree.</span> | | <br clear=all> |
|
| |
|
| == Workspace log == | | === Icons und Operationen === |
| *The '''system log''' will also reflect operations in the workspace.
| | {| class="wikitable options gnu big" |
| *In the "User" column the name of the workspace appears below the username:
| | | 1 || Änderungen anzeigen || öffnet Detailansicht |
| [[File:WorkspaceLogging.png|none]]
| | |- |
| | | 2 || Swap || tauscht den Arbeitsbereich und die Live-Version des Datensatzes |
| | |- |
| | | 3 || Vorschau-Element ||öffnet das Vorschaufenster |
| | |- |
| | | 4 || Element bearbeiten || editiert den Datensatz |
| | |- |
| | | 5 || Version der Seite öffnen || wechselt zum Modul '''WEB > Seite''' |
| | |- |
| | | 6 || Verwerfen || verwirft die Änderung |
| | |- |
| | | 7 || Datensatz auswählen || Aktiviert die Aktionsmenüs unten links |
| | |} |
|
| |
|
| = Administration = | | === Massenaktion === |
| == Versioning == | | [[File:WorkspaceModuleOverviewOperations.png|mini|600px]] |
| *TYPO3 CMS offers versioning of the database elements it manages.
| | Menü am unteren Rand: [[#Massenaktionen|Massenaktionen]] |
| *This versioning system allows you to work on future versions of content without affecting the live content.
| | <br clear=all> |
| *It is used by workflow systems to offer a process for such content, going from creation, editing to review and publishing.
| |
| *Versioning is available in the core API by default, but to gain access to management tools you must install the system extension "workspaces".
| |
| === Technical Details ===
| |
| *Versioning must be enabled on a per-table basis in the [https://docs.typo3.org/m/typo3/reference-tca/master/en-us/Ctrl/Index.html#ctrl "ctrl" section of the TCA array] for the given table.
| |
| *In addition a fixed set of fields has to exist for the management of versions.
| |
| *All of these technical details are specified in the [https://docs.typo3.org/m/typo3/reference-tca/master/en-us/Ctrl/Properties/VersioningWS.html#ctrl-reference-versioningws description of the "versioningWS" TCA property].
| |
| *All other versioning and workspace-related properties are also described there.
| |
| *Future and past versions of records in TYPO3 CMS remain in the same table as the live version.
| |
| *However, all "offline" versions have a pid value of "-1" to set them apart.
| |
| *Furthermore they have a database field called "t3ver_oid" which points to their live ("online") counterpart.
| |
| *When a future/past version is swapped with the live version it is done by ''swapping all field values except the uid and pid'' fields (and of course versioning related fields are manipulated according to their function). It means that online content is always identified by the same id as before and therefore all references are kept intact.
| |
| *Versioning is easy for existing elements. However, moving, creating and deleting poses other problems. This is solved the following way:* Deleting elements is done by actually creating a new version of the element ''and'' setting a flag in the new version (<span style="background-color:#f2f2f2;color:#ff5370;">t3ver_state = 2</span>) that indicates the live element must be deleted upon publishing the versions.
| |
| * Creating elements is done by first creating a placeholder element which is in fact live but carrying a flag (<span style="background-color:#f2f2f2;color:#ff5370;">t3ver_state = 1</span>) that makes it invisible online. Then a new version of this placeholder with the flag (<span style="background-color:#f2f2f2;color:#ff5370;">t3ver_state = -1</span>) is made which is what is modified until published.
| |
| * Moving elements is done by first creating a placeholder element which is in fact live but carrying a flag (<span style="background-color:#f2f2f2;color:#ff5370;">t3ver_state = 3</span>) that makes it invisible online. It also has a field, "t3ver_move_id", holding the uid of the record to move (source record). In addition, a new version of the source record is made with <span style="background-color:#f2f2f2;color:#ff5370;">t3ver_state = 4</span> (move-to pointer). This version is necessary in order for the versioning system to have something to publish for the move operation. So in summary, two records are created for a move operation in a workspace: The placeholder (online, with <span style="background-color:#f2f2f2;color:#ff5370;">t3ver_state = 3</span> and "t3ver_move_id" set) and a new version (<span style="background-color:#f2f2f2;color:#ff5370;">t3ver_state = 4</span>) of the online source record (the one being moved).
| |
|
| |
|
| ==== Unique fields ==== | | === Arbeitsbereich wechseln === |
| * Unique fields like a page alias or user name are tricky in a versioning scenario because the publication process must perform a check if the field is unique in the "Live" situation. The implications of implementing this means that we have chosen a solution where unique fields are simply not swapped at all! It means that publication of a new version of a page cannot and will not alter the alias of the live version. The "Live" unique value will remain until changed in the live version.
| | [[File:WorkspaceModuleOverviewChange.png|mini|600px|Klick auf Reisekarte]] |
| * You can hide fields with the "unique" keyword when there are offline versions. This is done with the display condition:
| |
|
| |
|
| <div style="color:#eeffff;margin-left:0cm;margin-right:0cm;"><span style="color:#82aaff;">'displayCond'</span> <span style="color:#ff5370;"><nowiki>=></nowiki></span> <span style="color:#82aaff;">'VERSION:IS:false'</span>,</div> | | <br clear=all> |
| ==== Permissions ====
| |
| This is an overview of how permissions are handled in relation to versioning:
| |
| ===== Display =====
| |
| * Read permissions are evaluated based on the live version of pages (as the basic rule). The read permissions of the offline page version in a workspace is not observed.
| |
| * The ID of the live record is used so the live records display- permissions get evaluated.
| |
|
| |
|
| ===== Versioning records ===== | | === Detailansicht === |
| * To create a new version the user must have read permission to the live record he requests to version
| | [[Image:WorkspaceModuleChangeDetails.png|mini|600px|Details zu einer Änderung anzeigen]] |
| * A new version of a page will inherit the owner user, group and permission settings from the live record
| | Popup-Fenster mit vollständigen Verlaufsinformationen |
| | <br clear=all> |
|
| |
|
| ===== Publishing version ===== | | == Vorschau == |
| * To publish, a user must have general publishing permission in the workspace, for instance be the owner of it or have access to the Live workspace. | | ; Vorschau des Inhalts |
| * In addition, the user must have read and edit access to the offline version being published plus edit access to the ''live version'' that a publishing action will substitute! | | Schaltfläche "Webseite anzeigen" |
| * The permissions of a new version of a page follows the page when published.
| | * Sobald Sie in einem Arbeitsbereich auf die Schaltfläche "Webseite anzeigen" klicken oder die Aktion "Seite speichern und anzeigen" verwenden, gelangen Sie zur Vorschau des Arbeitsbereichs |
| | * Dies ist auch direkt aus dem Modul ''Arbeitsbereiche'' möglich, wenn Sie auf die Schaltfläche "Elementvorschau" klicken |
|
| |
|
| ===== Editing records =====
| | Die Arbeitsbereichsvorschau ist eine gleichzeitige Ansicht der Live- und der Arbeitsbereichsversion |
| * For all editing it is required that the stage of the versioned record (or root point) allows editing.
| | * Standardmäßig wird die Arbeitsbereichsversion angezeigt und ein Schieberegler, mit dem Sie die Anzeige auf die Live-Version umstellen können |
| * Page records:
| |
| ** Permission to edit is always evaluated based on the pages own permission settings and not the live records. | |
| * Records from non-pages tables:
| |
| ** Always based on the live parent page.
| |
|
| |
|
| ===== New records =====
| | ; Ändern der geteilten Vorschau der Arbeitsbereiche |
| * When new records are created with a version and live place holder the permissions depend on the live page under which the record is created. | | [[Image:WorkspaceSplitPreview.png|mini|600px|Workspace split preview]] |
| | Mit dem Auswahlfeld in der oberen rechten Ecke können Sie den Modus etwa auf vertikale Aufteilung ändern: |
| | * Wenn Sie auf den Reiter "Listenansicht" klicken, gelangen Sie in die gleiche Ansicht wie im Modul ''Arbeitsbereiche'' |
| | <br clear=all> |
|
| |
|
| ===== Moving records ===== | | === Vorschau-Link === |
| * Records can be moved as long as the source and destination root point to a stage that allows it.
| | Vorschau Personen ohne [[Typo3/Backend|Typo3-Backend]]-Zugang zur Verfügung stellen |
| * New records created with a placeholder element can be moved freely around.
| |
| * Generally, the stage of a moved record has to allow for editing plus regular permissions for moving.
| |
|
| |
|
| ===== Deleting records =====
| | ; Vorschau-Link erzeugen |
| * If a record supports versioning it will be marked for deletion if all usual requirements are fulfilled at the time of the delete request: delete access to record, no subpages if recursive deletion is not enabled and no disallowed table records are found. As soon as the record is marked for deletion any change to the record and subpages that would otherwise prevent deletion for the user will not be effective. The record ''will'' be deleted upon publication!
| | [[Image:PreviewLink.png|mini|600px|Vorschau-Link erscheint in einem Popup-Fenster]] |
| * If you try to delete a Live record for which a version is found in the workspace, that version is deleted instead.
| | Klicken Sie auf die Schaltfläche "Seitenvorschau-Links generieren" in der Kopfzeile und kopieren Sie den Link aus dem Popup-Fenster |
| * Detaching versions from a workspace and raising stage of versions can be done as long as the user has edit permission to the record.
| | <br clear=all> |
|
| |
|
| == Workspaces == | | == Überprüfungsprozess == |
| *Workspaces are the user interface that sits on top of the versioning concept, to make it easier for users to manage versions.
| | [[Image:SendToAnotherStage.png|mini|600px|Send to another stage]] |
| *Furthermore workspaces make it possible to create a number of stages for validation of any given change, thus providing a complete review process before publication.
| | Weiterleitung einer Änderung an eine andere Stufe des Überprüfungsprozesses |
| *Users at all stages can be notified about changes in the review process.
| | * erfolgt über das Popup-Fenster der Detailansicht: |
| *A workspace is a state in the backend of TYPO3 CMS. | | * Senden einer Änderung an die vorherige oder nächste Stufe |
| *Basically there are two types of workspaces: | | <br clear=all> |
| #LIVE workspace: this is exactly the state TYPO3 CMS has always been in. Any change you make will be instantly live. Nothing has changed, it just got a name.<br/>Access to the Live workspace must be explicitly granted to backend users and groups (in the "Mounts and Workspaces" tab).
| |
| #Custom workspaces: when users select a custom workspace new rules apply to anything they do in the backend:
| |
| * Safety: any change they try to make will not affect the live website. It’s a safe playground.
| |
| * Transparent versioning: they can edit pages and elements because a new version is made automatically and attached to the workspace. No training needed, no administrative overhead!
| |
| * Previewing: visiting the frontend website will display it as it will appear when all versions in the workspace are eventually published.
| |
| * Overview of changes: the workspace manager module gives a clear overview of all changes that have been made inside the workspace across the site. This gives unparalleled control before making the content live.
| |
| * Constraints: only tables that support versioning can be edited.
| |
| * Flexibility: custom workspaces can be configured with owners, members and reviewers plus database mounts and more. A custom workspace can thus offer a more targeted editing area than backend users and groups. Plus a review process as simple or complete as needed.
| |
|
| |
|
| === Publishing and swapping === | | === Stufen === |
| *There are two ways to publish an element in a workspace; publish or swap.
| | ; Nächste/vorherige Stufe |
| *In both cases the draft content is published live. But when swapping it means the current live element is attached to the workspace when taken offline. *This is contrary to the publish mode which pushes the live item out of any workspace and "into the archive".
| | Änderung kann an die nächste Stufe gesendet oder an die vorherige Stufe zurückgeschickt werden |
| *The swapping mode is useful if you have a temporary campaign, say a Christmas special frontpage and website section.
| |
| *You create the Christmas edition in a custom workspace and two weeks before Christmas you swap in the Christmas edition. All normal pages and elements that were unpublished are now in the workspace, waiting for Christmas to pass by and eventually the old frontpage etc. will be swapped back in. The Christmas edition is now back in the workspace and ready for next year.
| |
| === Extensions and workspaces ===
| |
| Workspaces imply transparent support all over the backend and frontend and extensions must be programmed with this in mind. Although the ideal is complete transparency in backend and perfect previews in the frontend, this is almost impossible to obtain. Nevertheless a high level of consistency can be obtained by using the API provided by TYPO3 CMS. These functions and the challenges they are designed to address are discussed in [https://docs.typo3.org/m/typo3/reference-coreapi/master/en-us/ApiOverview/Workspaces/Index.html#workspaces TYPO3 Core API].
| |
|
| |
|
| ==Create a new Workspace==
| | ; Send to stage message |
| *Enter in the root page of your website and create a new Workspace
| | [[Image:SendToStageMessage.png|mini|600px|Send to stage message]] |
| [[Datei:Schermata 2021-02-24 alle 17.27.08.png|mini|ohne|New Workspace]] | | Sobald eine Stufe ausgewählt wurde, erscheint ein weiteres Popup-Fenster zur Eingabe einer Nachricht: |
| *We will call it Version 3.0
| | <br clear=all> |
| *Set all the fields according to your needs
| |
| [[Datei:Schermata 2021-02-24 alle 17.28.58.png|mini|ohne|New Workspace]]
| |
| *Save>close
| |
| *Except for the LIVE workspace (i.e. the default TYPO3 CMS working environment), some custom workspaces must be created before anyone can start using the features described in this document.
| |
| *By default a custom workspace contains three stages, which represent steps in the validation process: "editing", "ready to publish" and "publishing execute". Additional stages can be added.
| |
| === General === | |
| [[File:CustomWorkspaceGeneralTab.png|none]]
| |
| Entering the general information about the workspace
| |
| As with most records in the TYPO3 CMS universe, this is just about setting a clear title and a helpful description.
| |
|
| |
|
| === Users ===
| | Hinzufügen einer Nachricht beim Senden an eine andere Stufe |
| [[File:CustomWorkspaceUsersTab.png|none]]
| |
| Setting up owners and members of the workspace
| |
| This tab is about setting up user permissions. The "Owners" have all possible rights over the workspace, including publication to live. "Members" also have all the rights, although they may be prevented from publishing with the "Only workspace owner can publish" setting (see the [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#custom-workspace-other Other tab]).
| |
| <div style="color:#212121;">Note</div>
| |
| As usual, it is recommended to work with groups rather than individual users. "Admin" users have access to all workspaces and all operations within workspaces.
| |
| <div style="color:#212121;">Note</div>
| |
| Users must be given explicit access to the LIVE workspace. This is done at the level backend users or backend groups.
| |
| [[File:LiveWorkspacesPermission.png|none]]
| |
| Giving access to the LIVE workspace to a backend group
| |
|
| |
|
| === Notification settings ===
| | Die Nachrichten sind als Kommentare in der Änderungshistorie sichtbar |
| [[File:CustomWorkspaceNotificationsTab.png|none]]
| |
| Fine-grained definition for the notification process
| |
| Each time a given change or set of changes moves from one stage to another (either forward or backward in the review process), people can be notified about this status change. This tab is about defining the behavior of the notification process.
| |
| With "Stage change notification by email" you can choose who gets notified. This can be either all users involved in the workspace (no matter the stage) or only the users involved with the stage the changes are being sent to.
| |
| Subsequently you can configure settings for the three predefined stages.
| |
| <div style="color:#212121;">Note</div>
| |
| The screenshot is cropped. The settings are the same for each stage.
| |
| The "Settings dialog" is about the popup window which appears after each review process. If the "show dialog" box is not checked, the popup will not even appear and notifications will be sent according to the predefined settings. When the "changeable preselection" box is checked, the preselected list of users to notify can be modified on the fly before sending the change notification.
| |
| The "Preselection" setting makes it possible to choose which users should be preselected by default in the notification popup. Furthermore specific users can be added to the list of notified people using the "Default notification mail recipients" field.
| |
|
| |
|
| === Mountpoints ===
| | Sobald die Änderung das Stadium "Bereit zur Veröffentlichung" erreicht hat, kann jeder, der über die entsprechenden Rechte verfügt, sie in der LIVE-Version veröffentlichen, woraufhin sie auf der Website sichtbar wird |
| [[File:CustomWorkspaceMountpointsTab.png|none]]
| | * Beachten Sie, dass jeder, der zur Veröffentlichung berechtigt ist, direkt von jeder Stufe aus veröffentlichen kann |
| Setting alternate mountpoint for the workspace
| | * Eine Änderung muss also nicht in allen Phasen durchlaufen worden sein |
| A workspace can be restricted to one or more mountpoints. These need not be the same as the mountpoints from the users and groups that are allowed access to this workspace.
| |
| If no mountpoints are defined, the mountpoints from the users and the groups they belong to are used.
| |
|
| |
|
| === Publishing ===
| | [[Image:IndividualActions.png|mini|600px|Individual stage actions]] |
| [[File:CustomWorkspacePublishingTab.png|none]] | |
| Choosing a publication date for the custom workspace
| |
| If a "Publish" date is set, the content of the workspace will be automatically published on the given date. This requires the "Workspaces auto-publication" Scheduler task to be activated.
| |
| <div style="color:#212121;">Note</div>
| |
| Only the content which is "Ready to publish" is actually published.
| |
|
| |
|
| === Staging ===
| | Es ist auch möglich, eine Änderung an eine andere Stufe zu senden, indem Sie sie in der Übersicht auswählen und das Menü unten links verwenden: |
| Any number of custom stages can be created. Each corresponds to an additional step in the review process. Custom stages can be ordered at will. However they all come after the default "Editing" stage and before the default "Ready to publish" stage.
| |
| [[File:CustomWorkspaceStagingTabGeneral.png|none]]
| |
| Setting the general information of a custom stage
| |
| In the "General" tab of a custom stage, a restricted set of users can be chosen from among "Owners" and "Members". They are called "Responsible persons".
| |
| [[File:CustomWorkspaceStagingTabNotifications.png|none]]
| |
| Defining the notification settings of a custom stage
| |
| The notification settings for a custom stage are mostly the same as for the default stages, except that the "Responsible persons" can also be chosen in the predefined list of users to notify and that a "Default mail comment" can be defined for that stage.
| |
| <div style="color:#212121;">Note</div>
| |
| In this context "Editors" means the people that have been involved in the change originally.
| |
|
| |
|
| === Other === | | <br clear=all> |
| [[File:CustomWorkspaceOtherTab.png|none]]
| |
| Miscellaneous settings for a custom workspace
| |
| The "Other" tab is comprised of various settings affecting the behavior of the custom workspace.
| |
| The "Freeze editing" flag actually blocks all operations in the workspace until it is turned off again.
| |
| It is possible to allow editing of non-versionable records in the custom workspace. These records will be edited "live", i.e. any changes to them performed in the workspace will be directly visible on the web site, rather than going through the review process.
| |
| "Swap modes" defines if swapping should take place or not upon automatic publishing.
| |
| The "Publish access" setting further refines publishing rights. If the "Publish only content in publish stage" box is checked, modified content cannot be forcefully published by workspace owners at whatever stage. It has to reach the "Ready to publish" stage. Also publication can be restricted to the owners of the workspace (i.e. members may not publish).
| |
|
| |
|
| == Configuration Options ==
| | Eine oder mehrere Änderungen direkt an eine andere Stufe senden |
| There are a number of User TSconfig and Page TSconfig properties related to workspaces.
| |
| <div style="color:#212121;">Note</div>
| |
| Some of these options are actually handled by the "version" system extension, but apply to workspaces.* [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#page-tsconfig Page TSconfig]
| |
| ** [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#workspaces workspaces]
| |
| *** [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#splitpreviewmodes splitPreviewModes]
| |
| ** [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#options-workspaces options.workspaces]
| |
| *** [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#previewpageid previewPageId]
| |
| *** [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#enablemassactions enableMassActions]
| |
| ** [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#tx-version-workspaces tx_version.workspaces]
| |
| *** [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#stagenotificationemail-subject stageNotificationEmail.subject]
| |
| *** [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#stagenotificationemail-message stageNotificationEmail.message]
| |
| * [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#user-tsconfig User TSconfig]
| |
| ** [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#usertsconfig-options-workspaces options.workspaces]
| |
| *** [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#previewlinkttlhours previewLinkTTLHours]
| |
| *** [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#swapmode swapMode]
| |
| *** [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#changestagemode changeStageMode]
| |
| *** [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#allowed-languages allowed_languages]
| |
|
| |
|
| === [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#id2 Page TSconfig] === | | == Massenaktionen == |
| ==== [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#id3 workspaces] ====
| | [[Image:MassActionsMenu.png|mini|600px|Mass actions menu]] |
| ===== [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#id4 splitPreviewModes] =====
| |
| '''Data type'''
| |
| <div style="margin-left:0cm;margin-right:0cm;">String</div>
| |
| '''Description'''
| |
| <div style="margin-left:1cm;margin-right:0cm;">Comma-separated list of allowed values for preview modes. Possible values are "slider", "vbox" and "hbox".</div>
| |
| '''Example'''
| |
| <div style="color:#eeffff;margin-left:1cm;margin-right:0cm;">workspaces.splitPreviewModes <span style="color:#ff5370;"><nowiki>=</nowiki></span> slider</div>
| |
| <div style="margin-left:1cm;margin-right:0cm;">will restrict the preview mode to "slider".</div>
| |
| '''Default'''
| |
| <div style="margin-left:0cm;margin-right:0cm;">slider, vbox, hbox</div>
| |
| ==== [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#id5 options.workspaces] ====
| |
| ===== [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#id6 previewPageId] =====
| |
| '''Data type'''
| |
| <div style="margin-left:0cm;margin-right:0cm;">Integer / fieldReference per table</div>
| |
| '''Description'''
| |
| <div style="margin-left:1cm;margin-right:0cm;">Page uid used for previewing records on a workspace.</div>
| |
| '''Examples'''
| |
| <div style="color:#eeffff;margin-left:1cm;margin-right:0cm;"><nowiki># Using page 123 for previewing workspaces records (in general)</nowiki></div>
| |
| <div style="color:#eeffff;margin-left:1cm;margin-right:0cm;">options.workspaces.previewPageId <span style="color:#ff5370;"><nowiki>=</nowiki></span> <span style="color:#ffcb6b;">123</span></div>
| |
|
| |
|
| <div style="color:#eeffff;margin-left:1cm;margin-right:0cm;"><nowiki># Using the pid field of each record for previewing (in general)</nowiki></div>
| | Mit dem dritten Menü am unteren Rand |
| <div style="color:#eeffff;margin-left:1cm;margin-right:0cm;">options.workspaces.previewPageId <span style="color:#ff5370;"><nowiki>= </nowiki></span><span style="color:#ffffff;">field</span><span style="color:#ff5370;">:</span>pid</div>
| | * können Sie auch einen '''ganzen Arbeitsbereich''' auf einmal veröffentlichen, austauschen oder verwerfen |
|
| |
|
| <div style="color:#eeffff;margin-left:1cm;margin-right:0cm;"><nowiki># Using page 123 for previewing workspaces records (for table tx_myext_table)</nowiki></div>
| | Dieses Auswahlfeld |
| <div style="color:#eeffff;margin-left:1cm;margin-right:0cm;">options.workspaces.previewPageId.tx_myext_table <span style="color:#ff5370;"><nowiki>=</nowiki></span> <span style="color:#ffcb6b;">123</span></div>
| | * ''Massenaktionen'' genannt |
| | * ist nur aktiv, wenn kein Element ausgewählt ist |
|
| |
|
| <div style="color:#eeffff;margin-left:1cm;margin-right:0cm;"><nowiki># Using the pid field of each record for previewing (for table tx_myext_table)</nowiki></div>
| | ; Wichtig |
| <div style="color:#eeffff;margin-left:1cm;margin-right:0cm;">options.workspaces.previewPageId.tx_myext_table <span style="color:#ff5370;"><nowiki>= </nowiki></span><span style="color:#ffffff;">field</span><span style="color:#ff5370;">:</span>pid</div>
| | <blockquote> |
| ===== [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#id7 enableMassActions] =====
| | Die Massenaktionen wirken sich auf den '''gesamten Arbeitsbereich''' aus, d. h. auch auf die Änderungen, die im Modul Arbeitsbereiche nicht sichtbar sind, weil sie sich nicht im aktuell ausgewählten Zweig im Seitenbaum befinden |
| '''Data type'''
| | </blockquote> |
| <div style="margin-left:0cm;margin-right:0cm;">Boolean</div> | |
| '''Description''' | |
| <div style="margin-left:0cm;margin-right:0cm;">If set to "0", the mass actions menu will not be available to users.</div>
| |
| '''Default'''
| |
| <div style="margin-left:0cm;margin-right:0cm;">1</div>
| |
| ==== [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#id8 tx_version.workspaces] ====
| |
| ===== [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#id9 stageNotificationEmail.subject] =====
| |
| (<span style="background-color:#f2f2f2;color:#ff5370;">tx_version.workspaces.stageNotificationEmail.subject</span>)
| |
| '''Data type'''
| |
| <div style="margin-left:0cm;margin-right:0cm;">String / Localized string reference (using <span style="background-color:#f2f2f2;color:#ff5370;">LLL:</span> syntax).</div>
| |
| '''Description'''
| |
| <div style="margin-left:1cm;margin-right:0cm;">The default subject for the stage notification email.</div>
| |
| The following markers can be used for replacement:* <span style="background-color:#f2f2f2;color:#ff5370;"><nowiki>###SITE_NAME###</nowiki></span>
| |
| * <span style="background-color:#f2f2f2;color:#ff5370;"><nowiki>###SITE_URL###</nowiki></span>
| |
| * <span style="background-color:#f2f2f2;color:#ff5370;"><nowiki>###WORKSPACE_TITLE###</nowiki></span>
| |
| * <span style="background-color:#f2f2f2;color:#ff5370;"><nowiki>###WORKSPACE_UID###</nowiki></span>
| |
| * <span style="background-color:#f2f2f2;color:#ff5370;"><nowiki>###ELEMENT_NAME###</nowiki></span>
| |
| * <span style="background-color:#f2f2f2;color:#ff5370;"><nowiki>###NEXT_STAGE###</nowiki></span>
| |
| * <span style="background-color:#f2f2f2;color:#ff5370;"><nowiki>###COMMENT###</nowiki></span>
| |
| * <span style="background-color:#f2f2f2;color:#ff5370;"><nowiki>###USER_REALNAME###</nowiki></span>
| |
| * <span style="background-color:#f2f2f2;color:#ff5370;"><nowiki>###USER_USERNAME###</nowiki></span>
| |
| * <span style="background-color:#f2f2f2;color:#ff5370;"><nowiki>###RECORD_PATH###</nowiki></span>
| |
| * <span style="background-color:#f2f2f2;color:#ff5370;"><nowiki>###RECORD_TITLE###</nowiki></span>
| |
|
| |
|
| '''Default'''
| |
| <div style="margin-left:0cm;margin-right:0cm;">LLL:EXT:version/Resources/Private/Language/emails.xml:subject</div>
| |
| ===== [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#id10 stageNotificationEmail.message] =====
| |
| (<span style="background-color:#f2f2f2;color:#ff5370;">tx_version.workspaces.stageNotificationEmail.message</span>)
| |
| '''Data type'''
| |
| <div style="margin-left:0cm;margin-right:0cm;">String / Localized string reference (using <span style="background-color:#f2f2f2;color:#ff5370;">LLL:</span> syntax).</div>
| |
| '''Description'''
| |
| <div style="margin-left:0cm;margin-right:0cm;">The default message for the stage notification email. The same markers are available as for the subject (see above).</div>
| |
| '''Default'''
| |
| <div style="margin-left:0cm;margin-right:0cm;">LLL:EXT:version/Resources/Private/Language/emails.xml:message</div>
| |
| === [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#id11 User TSconfig] ===
| |
| ==== [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#id12 options.workspaces] ====
| |
| ===== [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#id13 previewLinkTTLHours] =====
| |
| '''Data type'''
| |
| <div style="margin-left:0cm;margin-right:0cm;">Integer</div>
| |
| '''Description'''
| |
| <div style="margin-left:0cm;margin-right:0cm;">Number of hours until expiry of preview links to workspaces.</div>
| |
| '''Default'''
| |
| <div style="margin-left:0cm;margin-right:0cm;">48</div>
| |
| ===== [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#id14 swapMode] =====
| |
| '''Data type'''
| |
| <div style="margin-left:0cm;margin-right:0cm;">String</div>
| |
| '''Description'''
| |
| <div style="margin-left:1cm;margin-right:0cm;">Possible values are:</div>
| |
| "any" - if page or element (meaning any record on the page) is published, all content elements on the page and page itself will be published regardless of the current editing stage.
| |
| <div style="margin-left:1cm;margin-right:0cm;">"page" - if page is published, all content elements on the page will be published as well. If element is published, its publishing does not affect other elements or page.</div>
| |
| ===== [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#id15 changeStageMode] =====
| |
| '''Data type'''
| |
| <div style="margin-left:0cm;margin-right:0cm;">String</div>
| |
| '''Description'''
| |
| <div style="margin-left:1cm;margin-right:0cm;">Possible values are:</div>
| |
| "any" - if page or element (meaning any record on the page) stage is changed (for example, from "editing" to "review"), all content elements on the page and page will change to that new stage as well (possibly bypassing intermediate stages).
| |
| <div style="margin-left:1cm;margin-right:0cm;">"page" - if page stage is changed (for example, from "editing" to "review"), all content elements on the page will change stage as well (possibly bypassing intermediate stages). If stage is changed for element, all other elements on the page and page itself remain in the previous stage.</div>
| |
| ===== [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/#id16 allowed_languages] =====
| |
| <div style="margin-left:1cm;margin-right:1cm;">'''Property'''</div>
| |
| <div style="margin-left:2cm;margin-right:1cm;">workspaces.allowed_languages.[workspaceId]</div>
| |
| '''Data type'''
| |
| <div style="margin-left:0cm;margin-right:0cm;">''(list of sys_language ids)''</div>
| |
| '''Description'''
| |
| <div style="margin-left:1cm;margin-right:0cm;">This is a list of sys_language uids which will be allowed in a workspace. This list - if set - will override the allowed languages list in the BE user group configuration.</div>
| |
| '''Example'''
| |
| <div style="color:#eeffff;margin-left:1cm;margin-right:0cm;">options.workspaces.allowed_languages.<span style="color:#ffcb6b;">3</span> <span style="color:#ff5370;"><nowiki>=</nowiki></span> <span style="color:#ffcb6b;">1</span>,<span style="color:#ffcb6b;">2</span></div>
| |
| <div style="margin-left:1cm;margin-right:0cm;">In this example, the user will be restricted to languages with "uid" 1 or 2 in the workspace with "uid" 3.</div>
| |
| == Scheduler tasks ==
| |
| The "workspaces" extension provides two Scheduler tasks.
| |
| '''Workspaces auto-publication'''
| |
| <div style="margin-left:0cm;margin-right:0cm;">This task checks if any workspace has a scheduled publishing date. If yes and if that date is passed, then all changes that have reached the "Ready to publish" stage are published to the Live workspace.</div>
| |
| '''Workspaces cleanup preview links'''
| |
| <div style="margin-left:0cm;margin-right:0cm;">When [https://docs.typo3.org/c/typo3/cms-workspaces/master/en-us/singlehtml/Index.html#users-guide-preview-link preview links] are generated, they are stored in the database (in table "sys_preview"). This task will delete any link which has expired.</div>
| |
|
| |
|
| | <noinclude> |
|
| |
|
| [[Kategorie:Typo3/Extension]] | | == Anhang == |
| | === Siehe auch === |
| | ; Unterseiten |
| | <div style="column-count:2"> |
| | {{Special:PrefixIndex/{{BASEPAGENAME}}/}} |
| | </div> |
| | |
| | ; Andere Artikel in der Kategorie |
| | <div style="column-count:2"> |
| | <categorytree hideroot=on mode="pages">Typo3/Workspaces</categorytree> |
| | </div> |
| | |
| | === Links === |
| | ==== Weblinks ==== |
| | # https://docs.typo3.org/c/typo3/cms-workspaces/main/en-us/singlehtml/Index.html |
| | |
| | [[Kategorie:Typo3/Workspaces]] |
| | |
| | </noinclude> |
