Guest User and Contribution plugins tutorial

Watch the screencast and read the documentation for the guest user plugin and the contribution plugin.

Worried about spammers? Read this documentation on enabling ReCaptcha.

About the guest user plugin

  • Adds an additional user role to your Omeka install
  • Works behind the scenes with other plugins, like contribution, without giving guests admin access to your Omeka site
  • Allows visitors to contribute items of a type or types of your choice to your Omeka site
  • All items remain private until approved by a site administrator
  • Contributors can also designate that their items remain permanently private, available only to users with access to the admin interface and not the general public

About the contribution plugin

  • Provides a new way to collect stories, images, and other files from the public and manage those contributions in your Omeka site as items
  • Contributors can share and upload content anonymously and their information will only be available to site administrators
  • Can automatically add a ReCaptcha box at the bottom of each form to prevent spam-bots from spamming your site
  • All contributions are private by default and require a site administrator to make them public

Installing the plugins

  1. Go to Plugins page on omeka.org and locate the guest user and contribution plugins.
  2. Download both plugins to your desktop. They should be zipped files.
  3. Go to Reclaim, log in to the client area, navigate to the cpanel, and then click file manager.
  4. Click public_html > omeka > plugins
  5. Click upload (top menu bar), and then either drag and drop the files from your desktop or select the files for uploading. Once the upload has completed, click the link at the bottom of the page to return to the previous screen.
  6. You’ll see a zip file for your plugins in the plugins folder. Click extract (top menu bar) to extract the plugins.

If you get stuck on this step, read Reclaim’s documentation on installing Omeka plugins.

Configuring the guest user plugin
screen1

  1. Navigate to the admin side of your Omeka install, and click on plugins (top menu bar). You should see the guest user and contribution plugins. You’ll first have to install and configure the guest user plugin before installing the contribution plugin, so we’ll come back to the contribution plugin in a minute.
  2. Click install on the guest user plugin and then you will be automatically redirected to the configuration page. You can enter text into the following fields: registration features, short registration features, dashboard label, login text, and register text. There are also checkboxes for allowing open registration and allowing instant access.

Using the guest user plugin
Screen Shot 2016-07-18 at 15.32.41

  1. Once guest user is installed and activated, you can manage guest users by going to the guest users tab (left hand side navigation menu).
  2. Clicking this tab brings you to a browse users page, with a table of the guest users displaying their user ids, username, real name, email, and role. You can also search through the users by username, real name, or email address.
  3. To edit a user, click the edit link below their username. There are three tabs on the edit guest user page: general, change password, and API keys.
  4. Screen Shot 2016-07-18 at 15.33.58

    • Under general you can: change the username, change the display name, update the user’s email, change the role of the guest user (not recommended), or make the user active or inactive.
    • Under the change password tab, you can enter a new password for the user without knowing their current password.
    • You can delete a user by either clicking the delete link under their username, or by clicking edit and then delete.

Activating guest users – only pertinent if you have not checked the allow open registration box when configuring the guest user plugin.
Screen Shot 2016-07-18 at 15.34.19

Screen Shot 2016-07-18 at 15.39.02

  1. Once users have begun signing up to contribute items, you will receive an email asking you to activate their account.
  2. Navigate to the admin side of your Omeka install, and click guest user (left hand side navigation menu).
  3. Under the username of the guest user awaiting activation, click the link that says edit. From here, click the box that says activate and save changes.
  4. The guest user will receive an email saying their account has been approved by an administrator.

Configuring the contribution form
Screen Shot 2016-07-18 at 15.42.15

  1. Navigate to plugins and activate the contribution plugin.
  2. Click on the contribution tab (left hand side navigation menu). The contribution page has three different tabs: getting started, contribution types, submission settings, and contributions.
    • Getting started: Instructions for setting up the form and submission settings.
    • Contribution types: To include questions on the public form, first choose the types of items you wish users to add (document, image, sound, moving images) and then create questions whose answers map to specific metadata fields.
      1. Click on the contribution types tab to select the item types you want contributors to select from on the public form. Read more about managing item types in Omeka here. Story and image types are already selected and you can add other existing types.
      2. Click add a type. Select item type, display name, and whether or not to allow file upload when this type is selected on the form.
      3. By adding an element, you can add metadata fields for information you wish to collect for those specific item types.
      4. When done, save changes.
    • Submission settings: You can enter text in the following fields: contribution slug, contribution confirmation email, new contribution notification emails, text of terms of service, email text to send to contributors. You can check the box to use simple options, and you can also designate the collection contributions will go into and a default contribution type.
    • Contributions: This is the tab is where you can view all submissions that have been received through the public contribution form. It is possible to review and make items public or change their status. All contributions will also be available to browse and search on the items tab in your Omeka site.