Development

Back end navigation

This chapter is about back end navigation. So far, you were able to manage all tasks with the navigation menu on the left by launching a particular back end module. However, in order to manage the variety of records that form a website, additional navigation elements are needed as shown in the next example.

User

Open back end module user. All users are listed in the main area. You might notice that administrator Kevin Jones is marked in a different color than Helen Lewis and James Wilson. This allows you to tell administrators apart from users without having to use the filter function.

Filtering records

The TYPOlight back end provides several tools to sort, filter and search records. Thus, you will not lose your bearings in a huge amount of data. Back end module user offers two filters. The first one selects all administrators or users without administrative privileges. The second allows you to select all active or inactive user accounts. Of course, you can combine multiple filters.

Sorting records

The sort function allows to sort records by various criteria, for example alphabetically by a member's first or last name. Sorting has not been enabled for module user but you can test it in module members.

Displaying records

Working with a lot of records, as in the system log module, can considerably slow down page loading. Typically, you only want to edit the first record and do not want to wait for a list of 300 records to be loaded. To prevent this, TYPOlight has a display function which limits the number of records per page to 30 (this value can be changed in settings).

Select the topmost option to reset a filter to its default value. In our example the display function is not needed as there are only three user accounts. Therefore, it does not make a difference which option you choose.

Searching records

The search function might be the most flexible and powerful tool to maintain records. You can search certain fields for a particular record and thus limit results to those records that match the search pattern. The search function supports regular expressions, like the asterisk (*) as wildcard for any character.

For example, enter "wi.*" into the search field to search for all names containing the sequence "wi". You should find James Wilson and Helen Lewis. To reset a search and display all records again, simply leave the search field empty and click Search.

Edit all records

With the Edit all records button you can edit several records simultaneously. After choosing a set of records, you will be redirected to a page displaying a list of available input fields. You can then choose which fields you want to edit. Fields you did not select or that you are not allowed to edit will be hidden automatically.

Navigation icons

To edit a particular record from a list, you can use the colored icons displayed at the right of each line. There is a short help tip for every icon that shows up if you hover the mouse pointer over the icon. Navigation icons differ depending on the current module and user permissions.

Edit Edit a record
Copy Duplicate a record
Copy with childs Duplicate a record with all child records
Move Move a record
Paste after Paste a record after the current one
Paste into Paste a record as child record
Show Show a record
Delete Delete a record
Undo Restore a deleted record
Switch user Switch user (administrator only)
Move left Move column left
Move right Move column right
Move up Move row/record up
Move down Move row/record down
Toggle line wrap Disable word wrapping
Collapse node Collapse a node
Expand node Expand a node

Saving a record

As you may have noticed while checking back end settings, there are different options on saving a record:

  • Save reloads the current page after saving
  • Save and close loads the previous page after saving
  • Save and edit loads the new record after saving

In case of an error, the current form will be reloaded regardless of the chosen option. An error message is then shown above the respective field. To prevent loss of data, any other correct input will be saved.

Attachments