Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Lesson 3.2: Site administrators, practical task

A 60-minute practical task for the end of the Site administration course, create a section and a limited role, assign it to a group, prove the limit with a test user, clear one cache group, run a cronjob part and take…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/trainers/assessments/module-03-administration-courses/site-administrators-practical-task.md

On this page

Lesson 3.2: Site administrators, practical task

A real administration job in one hour: a new team needs its own area of the site and a role that lets it edit there and nowhere else. The learner sets it up, proves it works with a test account, and does three routine jobs: a cache, a cronjob and a maintenance window.

Note

This is the trainer's own assessment, not an official certification. Each learner works on their own training installation as an administrator. Test users get addresses at example.invalid; the mail transport is file.

At a glance

CourseAssessments and practical exercises
ModuleModule 3: Assessing the administration courses
Duration85 minutes (5 briefing, 60 task, 20 scoring)
LevelIntermediate
AudienceLearners at the end of the Site administration course
PrerequisitesLesson 3.1; an Administrator account on the learner's own training installation

Learning objectives

Learners who pass this task have shown that they can:

  • create a section and assign content to it;
  • create a role with limited policies and assign it to a group;
  • prove a permission with a separate test account;
  • clear one cache group deliberately;
  • run a cronjob part from the administration;
  • take a site offline with a message and bring it back.

Trainer's notes

How to run it

  1. Before: one training installation per learner, installed fresh, with the mail transport set to file. The learner signs in as the installation's administrator.
  2. Briefing: hand out the steps and the rubric. 60 minutes. The guides may be open.
  3. Scoring: on each installation, read Setup > Sections, the role page, the test user's group, the cronjob page's recent runs and the maintenance page's recent changes (the latest eight switches are listed).

Common questions

A learner locks themselves out with maintenance mode. Maintenance keeps the administration reachable when it is switched on from the page. If a learner is locked out anyway, php bin/php/maintenance.php off brings it back. Score the step, then give the time back if the fault was not theirs.

May learners use the shell instead of the browser? Yes, where the result is the same.

Pitfalls

  • Testing with the administrator account. Administrators are not limited by sections; the test needs the test user.
  • Forgetting the role draft. Nothing changes until Save. A learner who closed the editor without saving has no role.

Hands-on exercise

The task, as handed to learners. Use your own training installation, signed in as administrator.

  1. In Setup > Sections, press New section. Name it Press area; keep the identifier it proposes and the navigation part Content structure. Press Create section.
  2. Create a Folder named Press below the content root and assign it, with everything below it, to the section Press area (Assign content on the section's page, or the folder's details).
  3. Create a user group Press team below the users.
  4. In Roles and policies, press New role, name it Press editors, and add policies with New policy: content read limited to the section Press area; content create and content edit limited to the section Press area. Press Save.
  5. On the role page, press Assign and choose the group Press team.
  6. Create a user press01 in Press team with the address [email protected] and a password you write down.
  7. In a private browser window, sign in as press01. Create an article inside Press. Then try to edit an item outside Press. Write down what you see. Sign out.
  8. In Setup > Caches, clear the group Templates only. Note the notice that follows.
  9. In Setup > Cronjobs, run the part that holds workflow.php (the frequent part by default) with Run part and watch the Output.
  10. In Setup > Maintenance, take the site offline with the message Training maintenance, back in 15 minutes, an expected duration of 15 minutes, and yourself allowed in; tick the confirmation and press Take the site offline. Open the public site in the private window: note what it shows. Then press Bring the site back online.

Expected result

  • Setup > Sections lists Press area with objects; the folder Press shows that section in its details.
  • The role Press editors has three policies limited to Press area and is assigned to Press team.
  • press01 created an article in Press and could not edit outside it.
  • The cache notice named the Templates group; the cronjob page lists the run; the maintenance page's recent changes show one switch off line and one on line, by the learner.
  • The trainer checks each page in the administration and asks the learner to explain step 7.

Scoring rubric

Criterion0: Not shown1: Partly2: Mostly3: FullyEvidence
SectionNoneCreated, no content assignedContent assigned, not the whole subtreeSection created, folder and subtree assignedSetup > Sections, the folder's details
Role and policiesNo role savedRole saved, policies unlimitedLimited, one function missingread, create, edit limited to the sectionThe role page
AssignmentNot assignedAssigned to a single userAssigned to the group, test user elsewhereGroup assigned, test user in itRole page, the group
Proof with test user (must)No testTested with the administratorTested, result not explainedTested with press01, both results explainedThe learner's note, the article
Routine jobsNoneOne of cache, cronjobBoth, one not what was askedTemplates group only, the right part runCache notice, cronjob recent runs
MaintenanceNot doneOn, not back onlineDone, message or duration missingMessage, duration, own access, back onlineMaintenance recent changes

Pass: 12 of 18 points or more and Proof with test user at 2 or 3. Without testing, nobody knows whether a role works.

Quiz

Debrief questions to ask after scoring.

  1. Why could the administrator account not prove the role?
  2. Visitors cannot see Press. Is that correct here, and what would you add if they should?
  3. Why clear only the Templates group, rather than all caches?
  4. What would have happened to approvals if the frequent part never ran?
Answers
  1. Administrators' policies are not limited by section, so everything is allowed (Sections).
  2. Yes for a press area in progress; for visitors, a policy for the Anonymous role to read the section (Sections).
  3. Clearing everything costs time while caches rebuild; clear what the change needs (Caches).
  4. Approved content would never be published (Workflows).

Further reading

Become an Exponential Partner

Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x