A tour of the admin

Go to /admin and sign in to reach the Admin Dashboard. It is the only page with a menu: the admin has no sidebar, so every other screen is opened from here, and the main screens have a Back button that returns here.

The dashboard, top to bottom#

Site Settings#

The Site Settings button is in the top right corner. It opens the five tabs that hold the site's name, look, features, prices and footer.

Growth Overview#

The chart draws two lines, Users and Listings.

• Period chooses the time span: Today, Yesterday, Last 7 Days, Last 30 Days or All Time. It opens on Last 30 Days. All Time draws the last six months.

• New shows how many were added in each slice of the period. Total shows the running total.

The period you choose also changes the small line under four of the tiles below.

The eight tiles#

Each tile is a link to the screen behind the number.

Recent Listings#

The nine newest listings, each with View and Edit. The All Categories menu narrows the list to one category, and View All opens Listings. Pills show whether a listing is Active or Pending, Featured and Verified.

Quick Actions#

The menu, on the right on a wide screen and above Recent Listings on a phone. The table below lists every entry.

Recent Reviews and System Status#

Under Quick Actions, Recent Reviews shows the last three reviews once there are any. System Status has four lines:

• Reviews reads Enabled or Disabled, following Enable Reviews in Site Settings.

• Approval Required reads Yes or No, following Require Listing Approval in Site Settings.

• Database always reads Online and User Registration always reads Open. They are fixed text, not checks.

Every screen in Quick Actions#

Two screens are not in the list. Site Settings has its own button at the top, and Custom Fields is opened from Site Settings, on the Features tab, with Manage Custom Fields.

The three roles#

Every account has one of three roles. The Users screen shows it in the Type column.

What only a super admin can open#

These refuse an admin with "Access denied. Super admin privileges required." and return them to the dashboard:

• Site Settings

• Add Listing, and the Delete All button on Listings

• Sales

• Users

• Cities

• Google Places

• Advertising

An admin who clicks the Total Users, Sales Revenue or Active Cities tile gets the same refusal.

Make a second admin#

There is no "add user" button. The person makes their own account and you raise it.

1. 1

   Step 1: Have them create an account

   They choose Create Account on your site and confirm their email address from the link they are sent. Until they confirm, they cannot sign in.

2. 2

   Step 2: Open Users

   Open Users under Quick Actions. The tabs are All Users, Regular Users, Administrators, Inactive and Unverified Email.

3. 3

   Step 3: Promote them

   On their row click Actions, then Promote to Admin.

4. 4

   Step 4: Give full control only if you mean to

   An admin's Actions menu has Promote to Super Admin. A super admin can change every setting, see all revenue and remove other admins, you included. Use it when you hand a site over.

The same menu has Deactivate User, Demote to User, Demote to Admin and Delete User. Deleting a user deletes their listings and the reviews on those listings with them.

python scripts/create_admin.py --username sam --email [email protected] --password a-strong-password