Plugins/Contribution 2.0

There is a screencast for this plugin

The Contribution plugin provides a way to collect stories, images, and other files from the public and manage those contributions in your Omeka site as items. Contributors may share and upload content anonymously, and their information will only be available site administrators. The form can also automatically add a reCAPTCHA box at the bottom of each form to prevent spam-bots from spamming your website.

All contributions are private by default and require a site administrator to make them public on the Omeka site.

Contribution offers site administrators the ability to let contributors create guest user accounts to better enable multiple contributions from the same user. Administrators can collect specific information about those users with the User Profiles plugin.

An Omeka site with the Contribution plugin now requires you to upload and install two separate plugins. There are two additional plugins you will need to install if you want to collect any user information:

Initial Set Up

Upload and install the Guest User plugin first. Contribution settings: A new tab will appear in the left side navigation bar labeled, “Contribution.” Click on Contribution to configure the form and submission settings.

  • Note: a link to the contribution form will automatically be added to the site’s navigation. If you wish you draft the form first, go to the site’s Appearance tab at the top of the Dashboard and click on Navigation. Uncheck the “Contribute an Item” link. At this point you can edit the label, or do that later.

Guest User Configuration

Configure Guest User before setting up your Contribution plugin. See the documentation for more detailed instructions.

Some hints on working with Contribution and Guest User

  • Let visitors know a bit about how their contributions will be used and why they are so valuable in the 'Registration Features' information.
  • All contributors must register as a guest user in order to contribute.
  • It is easiest to contribute if administrator approval is not required and you allow 20 minute instant access. To prevent spam, using ReCaptcha is recommended.
  • Additional contribution-specific information for guest users can be created here.

Setting up Contribution

Contribution is managed from the plugin's tab on the left-hand navigation of the admin dashboard.

The Contribution section has four tabs: Getting Started, Contribution Types, Submission Settings, and Contributions.

Contribution main.png

Getting Started

The Getting Started tab offers instructions for setting up for the form and submission settings.

Contribution Types

The Contribution Types section is where you choose what type of items users can share through this form (still image, audio, video, document/story), and where you ask questions about what users are sharing. The tab has a table with a row for each type. Every row shows: - the type's name (the label you give it); - its type (corresponding Item Type from your Omeka install); - the number of Contributed Items (which also acts as link to those items); - whether File Upload is allowed, disallowed, or required; and - an Edit button.

Contribution-types1.png

Click Edit to add or change data collection for a specific type. Click Add to create a new type to collect.

On the Add/Edit screen for Contribution Types, there are fields for the display name and form upload, and a series of element inputs for the data you will collect from contributors.

Contribution-story.png

Options are: - Display Name is the label for the contribution type - how it will appear on the public side. If left blank, the form will use the Item Type name. - Allow File Upload Via Form: you can choose to allow, require, or disallow. If this is set to "required," users will not be able to submit the contribution form without attaching a file. - Elements: each element appears as a block. - The block is labeled with the Dublin Core field name - Prompt is what appears on the form. Use this field to ask question or describe what you seek from users, ie, "Share your story" or "When did you take this photograph?"
- The Multiple Rows checkbox sets whether the entry field on the form has a single row (indicating a short answer) or allows for multiple rows (making it easier for contributors to write paragraphs of text).

To add an element (question) to the contribution form: - Go "Add Element". - Select an element from the dropdown list (this includes all the Dublin Core fields as well as all Item Type elements.) - Type a prompt or question in the Prompt field. - If you want contributors to be able to enter longer blocks of text, click the Multiple rows checkbox. - Save changes.

You can edit any element's prompt or multiple row setting at any time.

To delete an element, click the X button in the right corner of the block and save changes. If you accidentally click the delete button, you can click again (the X changes to an undo arrow) to restore the block.

Contribution addEl.png

In the above image, the upper block has marked for deletion - note that the header for the block is highlighted in red. The lower block is the add element block option with the dropdown open.

If you want users to select from a drop-down instead of entering text, use Simple Vocab to set up a controlled vocabulary for the element which will be applied on the admin side when adding/editing an item and in contribution forms.

If you want users to be able to assign a location to their contributions, use the Geolocation plugin and check the add map to contribution form in its configuration settings.

Submission Settings

In this section, you set the contribution options for your form, including an option for user anonymity and type in the text of email confirmations sent to contributors.

  • Contribution Slug: customize the end of the url for the contribution form (youromekasite.net/slug). If you leave this blank, the url for the contribution form will be youromekasite.net/contribution

Email settings - Contribution Confirmation Email : An email message will be sent to each contributor from this address confirming that they submitted a contribution to this website. Leave blank if you do not want an email sent. - New Contribution Notification Emails: Add emails to which you want a notification sent when new contributions are received. You can enter multiple email addresses, separated by a comma.

Terms of Service - Terms of service: paste in text of language of consent for anyone contributing to the site, or make a short statement linking to a Simple Page with a longer terms of service statement.

Contributor anonymity settings Two checkboxes allow an Administrator to set the user requirements for submitting contributions.

These settings work in conjunction to permit varying levels of anonymity for your contributors. For instance, you may require users to sign up and have an approved account before contributing, require them to provide an email before contributing, or permit completely anonymous contributions.

Contribution anon.png

  • Allow non-registered contributions requires that contributors only provide an email address. Select this option if you have set up the Guest User plugin enabling “instant access.” These contributors will get an email that allows them the option of creating a password for their user account.
  • Allow Anonymous contributions can only be used if Allow non-registered contributions is checked. You cannot allow anonymous contributions without allowing non-registered contributions.

The boxes work together as follows: - No boxes checked: site visitors have to create a Guest User and wait for their account to be approved before they can make contributions to the site. - "Allow non-registered" checked: visitors can make a contribution without creating a Guest User account but must provide an email address; they then have the option of completing registration by creating a password. They can also create an account as above. - Both "Allow non-registered" and "Allow anonymous": visitors can still create accounts or just provide an email, but they have the option to contribute items completely anonymously, without providing an email address or any other identifying information.

Additional Settings - Email text to send to contributors: the text of the email sent to contributors when they contribute an item. - Contribution Collection: If you want, you can specify a collection to which all new contributed items will be added (note that you must create the collection before you can select it from this dropdown). - Default Contribution Type: If you select a type, it will automatically load when someone navigates to the public contribution form.

If User Profiles is installed - If you’re collecting user data with the User Profiles plugin, you must select which profile to make available for your contribution users. See below for more information about creating a user profile.

Remember to save changes.

Older versions

If you are running Contribution versions 3.0.3 or lower, the Contributor Anonymity settings will be a single checkbox instead of two:

Contribution-simple.png

Use 'Simple' Options: requires that contributors only provide an email address. Select this option if you have set up the Guest User plugin enabling “instant access.”

The Simple Options are equvialent to selecting "Allow non-registered contributions" but not "Allow anonymous contributions" on newer versions of the plugin.

Contributions

This tab is where you manage and view all submissions. From this screen, it is possible to review and make items public or change their status. All contributions through the form will also be visible to browse and search on from the Items tab in your Omeka site.

Collecting Information from Contributors (optional)

To ask for additional information about your contributors, you will need to install 2 additional plugins. If you were not collecting contributor information, you do not need to install Record Relations or User Profiles to use Contribution.

  1. Upload and install the Record Relations
  2. Upload and install the User Profiles. Once Record Relations is installed, the User Profiles plugin will become available to install. Follow directions for creating user profiles in that plugin's documentation.

Adding Contribution link to Site Navigation

  • A link to the contribution form is automatically added to the main site navigation.
    • Go to the site’s Appearance tab at the top of the Dashboard and click on Navigation. You may rename the public link to the Contribution form, the default label is “Contribute an Item.”
  • Drag and drop the links if you wish to re-order the navigational elements of your site.

Vetting and Managing Contributions

All new contributions will be private, and by default will be marked as “Needs Review.”

  1. To review, go to the Contributed Items tab in the left navigation (once you start collecting, this tab changes name from Contribution to Contributed Items).
  2. Go to the Contributions tab and browse contributions.
  3. You may filter by status to see what Needs Review. Any item you wish to approve, you must make public and save changes.
    • Users have the option to contribute an item that they do not wish to be made public. You will not be able to override this request from the user, so you cannot make those items "public."
    • Contributors can also make their contributions anonymously. In that case, contributor information is only visible to site administrators.

Upgrading from 1.x to 2.x

Be sure to make a copy of the plugin’s files and a backup copy of the database before upgrading.

1. Follow upgrading process for all Omeka sites.

2. Upload and install the following plugins:

Follow all of the steps above for installing plugins and configuring the form above.

3. If you have asked Contributor Questions on 1.5 form, go to User Profiles plugin page. Locate the check box asking if you want to import Contributor settings: check the box and save changes.

4. Contributor pages should be linked to a Contributor’s profile, and the questions you asked before should be available in the User Profile.

5. If you have modified the text on the Contribution form itself, those changes will not be transferred. You will need to modify the text on the contribute.php form again in the plugin directory on the server.