Skip to content

Commit 6ed1d12

Browse files
committed
[TASK] Restore the backend section
Many screenshots are outdated and the content also needs to be updated. We have to do that step by step however. These contents where deleted with #145 Resolves: #416 Releases: main, 13.4, 12.4
1 parent daaf9c7 commit 6ed1d12

File tree

109 files changed

+1149
-40
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

109 files changed

+1149
-40
lines changed
Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
.. include:: /Includes.rst.txt
2+
.. index::
3+
Modules; Filelist
4+
Filelist
5+
.. _file-module:
6+
7+
===================
8+
The Filelist module
9+
===================
10+
11+
The **FILE > Filelist** module is where you can manage
12+
all the media associated with your TYPO3 web site.
13+
14+
.. index::
15+
Files; Management
16+
Directories; fileadmin
17+
.. _managing-files:
18+
19+
Managing files in the TYPO3 CMS
20+
===============================
21+
22+
Files including documents and images are managed in the
23+
Filelist module. Similar to the **WEB > List** module,
24+
it displays a navigation tree, which corresponds to the file
25+
structure on the server, and a list of all files for the
26+
selected directory.
27+
28+
.. include:: /Images/AutomaticScreenshots/FilelistModule/FilelistModule.rst.txt
29+
30+
For admin users, the folder displayed by default is called
31+
"fileadmin/ (auto-generated)" and corresponds to the
32+
:file:`fileadmin/` folder located under the document root
33+
folder on your web server.
34+
35+
Using these files inside content elements to display them
36+
or link to them in your web site is covered in the
37+
:ref:`Editors Tutorial <t3editors:images>`.
38+
39+
.. note::
40+
41+
There are extensions which make it possible to connect to remote
42+
storage pools (like a WebDAV server or an Amazon S3 account) and work
43+
with the files as if they were on the TYPO3 CMS server.
44+
45+
46+
.. index:: pair: Files; Clipboard
47+
48+
.. _file-module-clipboard:
49+
50+
Clipboard
51+
---------
52+
53+
There's a clipboard just like in the *List* module.
54+
55+
.. include:: /Images/AutomaticScreenshots/FilelistModule/FileClipboard.rst.txt
56+
57+
Using the action icons, files can be renamed or replaced
58+
(just hover over the icons and you will get a help text).
59+
60+
61+
.. index:: Files; Upload
62+
.. _uploading-files:
63+
64+
Uploading new files
65+
-------------------
66+
67+
You can upload files to a given folder by using the context menu
68+
or to the current directory by using the action icon in the docheader.
69+
70+
.. include:: /Images/AutomaticScreenshots/FilelistModule/FileUpload.rst.txt
Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
.. include:: /Includes.rst.txt
2+
.. index:: Context menu
3+
.. _context-menu:
4+
5+
=================
6+
The context menus
7+
=================
8+
9+
While learning about the :ref:`page tree <page-tree>`,
10+
we were introduced to contextual menus
11+
when selecting icons in the Page module.
12+
13+
Contextual menus exist throughout the CMS's
14+
backend. You will notice that different sets of
15+
icons appear depending on what page you are on
16+
what actions you are performing.
17+
18+
For example, there's a contextual menu in the **WEB > List** view:
19+
20+
.. include:: /Images/AutomaticScreenshots/ListModule/ContextMenu.rst.txt
21+
22+
or in the **FILE > Filelist** view:
23+
24+
.. include:: /Images/AutomaticScreenshots/FilelistModule/ContextMenu.rst.txt
25+
Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
.. include:: /Includes.rst.txt
2+
.. index::
3+
Backend
4+
Modules
5+
.. _docheader:
6+
.. _general-backend-structure:
7+
8+
=========================
9+
General backend structure
10+
=========================
11+
12+
Here is a complete overview of the backend interface and its structure.
13+
14+
Situated in the center left of page is the
15+
*page tree* and to its right the (main) *content area*.
16+
17+
Top bar (top)
18+
This gives you access to your user settings, logout, search
19+
etc.
20+
21+
Module menu (left)
22+
This is the main menu of the TYPO3 CMS backend. It is divided
23+
into main modules (:guilabel:`WEB`, :guilabel:`FILE`, etc.) and
24+
their sub-modules.
25+
26+
Page tree (middle)
27+
This can be used to browse through and select pages.
28+
29+
Content area (right)
30+
This is where you can edit pages and content elements.
31+
32+
Docheader (top)
33+
The *docheader* contains contextual icons including close, save and preview.
34+
It also features other information and a drop-down menu with further actions
35+
which will appear depending on what actions you are performing.
36+
37+
.. include:: /Images/AutomaticScreenshots/BackendOverview/BackendAreasOverview.rst.txt
38+
39+
We will have a closer look at the individual parts in the next pages.
40+
41+
.. toctree::
42+
:maxdepth: 1
43+
:titlesonly:
44+
45+
TopBar/Index
46+
PageTree/Index
47+
ContextMenu/Index
Lines changed: 222 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,222 @@
1+
.. include:: /Includes.rst.txt
2+
.. index:: Backend; Page tree
3+
.. _page-tree:
4+
5+
=========
6+
Page tree
7+
=========
8+
9+
.. sectionauthor:: name <email>
10+
11+
The page tree represents the hierarchical structure of your site and its pages. In
12+
most cases this corresponds exactly to the navigation structure
13+
of your web site. The page tree can be expanded by clicking
14+
the arrow to the left of each page.
15+
16+
.. rst-class:: bignums
17+
18+
19+
1. :ref:`Enter the backend <backend-login>` and select the page module
20+
21+
Click on **WEB** > **Page** now.
22+
23+
2. Look at the page tree in the backend:
24+
25+
For example, click on the arrow next to the page called "Congratulations",
26+
and then "Content Examples".
27+
28+
Your page tree should look like this:
29+
30+
.. include:: /Images/AutomaticScreenshots/PageTree/PageTree.rst.txt
31+
32+
33+
3. View page in the frontend:
34+
35+
To view the page in the frontend, click on the :guilabel:`View webpage`
36+
icon in the Docheader.
37+
38+
.. include:: /Images/AutomaticScreenshots/PageModule/ViewWebpage.rst.txt
39+
40+
4. Now take a look at the navigation in the frontend.
41+
42+
Click on :guilabel:`CONTENT EXAMPLES` in the main menu on top and then
43+
select :guilabel:`Media` from the sub-menu:
44+
45+
.. figure:: /Images/ManualScreenshots/Frontend/FrontendPage.png
46+
:alt: Frontend of the Introduction Package
47+
:class: with-shadow
48+
49+
The main menu on top of your web site corresponds to the first
50+
level menu pages in the page tree. The sub-menu of the :guilabel:`"Content Examples"`
51+
page in the frontend corresponds to the entries beneath "Content Examples" in the page tree.
52+
53+
.. index:: Root page
54+
55+
Working with the page tree
56+
==========================
57+
58+
Remember the components of the backend from the :ref:`previous page <general-backend-structure>`?
59+
60+
.. include:: /Images/AutomaticScreenshots/BackendOverview/BackendAreasOverview.rst.txt
61+
62+
We will now look at some components of the page tree a little more closely:
63+
64+
65+
Root page
66+
The page with the globe icon represents the root of your web site.
67+
Multiple websites can exist within a single installation of TYPO3.
68+
The top node with the TYPO3 logo is a special container which is used
69+
to store shared resources such as file mounts and backend user records.
70+
71+
.. include:: /Images/AutomaticScreenshots/PageTree/RootPage.rst.txt
72+
73+
Modules:
74+
Some modules make use of the page tree, but not all. The presence of the page tree
75+
implies that the module depends upon the selection of a specific pages in the page tree.
76+
77+
Content area:
78+
Clicking on a pages title opens that page in the content area to
79+
the right. Hovering over the icon of a page will display its internal id.
80+
81+
Context menu:
82+
1. A click on the page icon will open the context menu. 2. **Or**, you
83+
can right click the whole page title.
84+
85+
.. include:: /Images/AutomaticScreenshots/PageTree/ContextMenu.rst.txt
86+
87+
88+
.. index:: Page tree; Context menu
89+
.. _the-context-menu:
90+
91+
The context menu
92+
================
93+
94+
The context menu of a page is used to access the most common
95+
page related functions. Here is what these options do:
96+
97+
- **Show**: Opens the page you clicked in the browser (frontend)
98+
99+
- **Edit**: Lets you edit the page properties
100+
101+
- **New**: Create a new page
102+
103+
104+
.. important::
105+
106+
This creates a new page under the current page on the same level in the page
107+
tree:
108+
109+
.. code-block:: none
110+
111+
parent
112+
|
113+
---> current page
114+
|
115+
---> new page
116+
117+
If you wish to create a new page, as subpage of current page, use "More options"
118+
> 'Create New' wizard" or use :ref:`new-page-drag-and-drop`.
119+
120+
.. code-block:: none
121+
122+
parent
123+
|
124+
--> current page
125+
|
126+
---> new page
127+
128+
129+
- **Info**: Displays information about the page
130+
131+
- **Copy**: Copies the page
132+
133+
- **Cut**: Cuts the page
134+
135+
- **More options**:
136+
137+
- **More options ... > 'Create New' wizard**: Same as "New", but you can select where
138+
the new page is to be created.
139+
140+
- ...
141+
142+
- **More options ... > Export**: Opens the export tool and preselects the selected page
143+
144+
- **More options ... > Import**: Opens the import tool and preselects the selected
145+
page
146+
147+
- **Disable**: Disables the page (so it isn't accessible from the frontend
148+
anymore)
149+
150+
- **Delete**: Deletes the page
151+
152+
- **History/Undo**: Shows the change history of the page (who did which
153+
changes when)
154+
155+
156+
.. index:: Pages; Create
157+
.. _new-page-drag-and-drop:
158+
159+
Create new pages with drag and drop
160+
===================================
161+
162+
You can also create new pages using drag and drop.
163+
164+
.. rst-class:: bignums
165+
166+
1. Clicking on the "Create new pages" icon (top left of the page tree)
167+
168+
2. Drag and drop a "Standard" page to its desired location in the page tree.
169+
170+
171+
.. figure:: /Images/ManualScreenshots/PageTree/Dragndop1.png
172+
:class: with-shadow
173+
174+
.. figure:: /Images/ManualScreenshots/PageTree/Dragndop2.png
175+
:class: with-shadow
176+
177+
3. A new page has now been created at the desired location.
178+
179+
By default it will be called "[Default Title]" which can be changed
180+
right away by entering a new title.
181+
182+
.. figure:: /Images/ManualScreenshots/PageTree/Dragndop3.png
183+
:class: with-shadow
184+
185+
186+
.. index:: Modules; View
187+
.. _the-view-module:
188+
189+
The view module
190+
===============
191+
192+
It is also possible to view a page without having to leave the backend. By selecting the View module,
193+
backend users are able to preview individual pages and test them against various screen sizes,
194+
by accessing the drop-down menu at the top.
195+
196+
.. figure:: /Images/ManualScreenshots/Modules/ViewModule.png
197+
:alt: Viewing a page directly in the backend
198+
:class: with-shadow
199+
200+
201+
.. index:: Page tree; Collapse
202+
.. _collapse-page-tree:
203+
204+
Collapsing the page tree
205+
========================
206+
207+
The page tree can be collapsed to gain screen space, by clicking on the second icon
208+
on the left in the top bar.
209+
210+
.. include:: /Images/AutomaticScreenshots/PageTree/CollapsePageTree.rst.txt
211+
212+
213+
.. index:: Pages; Edit
214+
.. _editing-pages:
215+
216+
Editing pages
217+
=============
218+
219+
Modifying an existing page or adding a new one is covered in the
220+
:ref:`Editors Tutorial <t3editors:pages>`.
221+
222+
Next we will look at how content is placed on pages.

0 commit comments

Comments
 (0)