Plugins/GuestUser 2.0

The Guest User plugin adds an additional user role to your Omeka site. The Guest role works behind the scenes with other plugins (Commenting, and User Profiles, for example), without giving the guests admin access to your Omeka site.

There is a screencast which demonstrates the use of Guest User in conjunction with Contribution.

Install and Configure

After installing the plugin, you should be automatically redirected to the configuration settings for the plugin. You can access these again at any time by clicking the Configure button for Guest User from the Plugins menu.

You can enter text for the following fields:

  • Registration Features: this text will appear at the top of the registration page. You can use it to explain what users are signing up to do, and what the limitations may be.
  • Short Registration Features: brief text appearing as a dropdown from the user bar.
  • Dashboard Label: By default, this is "My Account" and will appear when the user is logged in.
  • Login Text: What is displayed for the login button, defaults to Login.
  • Register Text: What is displayed for the Register link, defaults to Register.

There are also two checkboxes:

  • Allow open registration to allow individuals to register without administrators approving their accounts.
  • Allow instant access enables new users to access their accounts for 20 minutes after registering without administrator approval.

If you have ReCaptcha enabled, you can require a ReCaptcha key for registration.

GUConfig1.png GUConfig2.png

Using the Plugin

Guest User supports certain plugins, such as Contribution, Posters, and User Profiles.

Once Guest User is installed and activated, you can manage the guest users by going to the Guest Users tab on the left-hand side navigation on your admin dashboard, below Items, Collections, etc.

Clicking on this tab will bring you to a Browse Users page, with a table of all guest users. The table displays the guest user ID, Username, Real Name, Email, and Role. There are also options to search users by username, real name, email address.


To edit a guest user, click the Edit text button below their username. The options presented will be very similar to the normal options for managing Omeka users. There are three tabs on the Edit Guest User page: General, Change Password, and API keys.

Under General you can:

  • change the Username
  • change the Display Name
  • update the user’s Email
  • change the Role that the guest user has (not recommended)
  • mark the user active or inactive.

The Change Password tab requires you to enter the new password twice but does not require that you know the current password for that user.

You can delete a guest user either by clicking the Delete text button under their username, or by clicking Edit and the Delete.

Hiding the Register & Login Header

When you activate Guest User, it adds a header bar with Login and Register links to the public side of your site. If you want to hide this header bar, you will need to edit the code of the plugin.

From your file manager, go to the folder for the Omeka Site, then to the plugins folder and open the GuestUser folder.

Open the file titled “GuestUser.php” using a plain text editor suitable for writing and editing code.

Comment out lines 24 and 25 . Commenting out uses /* and the end result should look like this:

      /* 'public_navigation_admin_bar',
       'public_show_admin_bar’, */

This will remove the general login/register links which are as follows: Login: yoursiteurl/users/login Register: yoursiteurl/guest-user/user/register

You might want to hard code those into a Simple Page or preserve the links somewhere else on your site.