EWZ-Rating Plugin

This plugin requires that the EntryWizard plugin is installed. It generates forms for displaying and judging images that were uploaded via EntryWizard ( either using its regular individual upload or using its batch entry upload facility ).

The data displayed in the forms, the judges allowed to see it, and the selection of images shown may all be configured by the administrators.

Judges may sort the forms by most columns, including any scores they have entered.

Selected information about each image and/or maker may optionally be displayed in read-only fashion.

The judges must be logged-in users of the site who have been assigned a special role. Or the administrator may make the images and data visible to all logged-in users, or only to the image owners.

Privacy

This plugin does not send any data to external servers. It does store in the wordpress database whatever data is requested in the forms designed by the administrator. Viewing of such data using the plugin’s shortcodes is always restricted to logged-in users, and is usually further restricted by the administrator.

• Either

  • Go to Plugins -> Install New and search for EWZ-Rating. Click “Install Now”.
    Or
  • Download and unzip the file into your plugins folder.

• In the administration area, go to Plugins, look for “EWZ-Rating”, and click “activate”.

• The “Rating Forms” and “Rating Schemes” links should appear on the administration sidebar in the EntryWizard menu.

Usage

• As with EntryWizard, most inputs in the administration area have popup help displays describing their use.

• A rating-scheme is quite similar to an EntryWizard layout — it specifies the format of the form generated by the ewz_show_rating shortcode.

• Because it may use some of the layout fields for displaying read-only data, each rating-scheme applies to just one layout. Thus to create a rating-scheme you first have to select a layout.

• A rating-form is analagous to an EntryWizard webform. It specifies a form to be displayed by the ewz_show_rating shortcode. For each form, you may specify which images are displayed, and which judges have access.

• Once the judging is complete, the administrators may download a spreadsheet containing the entered scores/comments in one of two possible forms – either one line per rating, or one line per image.

• If needed, further forms for tiebreaking, etc, may be generated that contain only specified images, and are visible only to specified judges.

• Quickstart for the impatient ( for further details, click on the information buttons ):

  1. Assign the “EntryWizard Judge” role to your judges ( it may be helpful to have a plugin installed that allows users to have multiple roles ).

  2. In the EntryWizard “Rating Schemes” page, select the layout you wish to use and click “Add a New Scheme”.

  3. Give the scheme a name. Drag the fields you wish to display to the judges into the right-hand column.

  4. Add any fields you wish the judges to fill out ( works like EntryWizard fields ).

  5. Set the image size, background color and text color, and save the scheme.

  6. In the EntryWizard “Rating Forms” page, select your scheme and click “Add a New Rating Form”.
     All webforms with your selected layout should display in the “Item Selection” list.
     All your members with “EntryWizard Judge” role should display in the “Access Control” list.

  7. Fill out the name, identifier, webform(s) and judges, open the rating form and save.

  8. Create a page containing the shortcode [ewz_show_rating identifier=”.. your identifier here ..”].
     Clicking on a thumbnail in the page should open a new window containing a larger version of the image.
     Subsequent clicks on other thumbnails should cause the selected image to display in the same window.
     ( If you normally have new windows open in tabs, you may need to drag the tab out of the browser window ).

  9. Once the judging is over, download the results in a spreadsheet.

  10. If further information is required about specific images, or ties need to be broken, create a new page with
      [ewz_show_rating ….] shortcodes tailored to your needs ( see the help item at the top of the Rating Forms page ).

1.1.24

• Fix required for new block themes to make the javascript used in shortcodes work properly. Not needed for classic themes

1.1.23

• Some extra buttons on the admin pages, to improve handling of large number of schemes and webforms.

1.1.22

• Fixed a bug in saving a rating scheme that only occurs when using PHP 8.

1.1.21

• Fixed very slow behaviour if both “Show drop-down selections as buttons” and “Go to next item after ” are set on a large judging.

1.1.20

• Fixed error handling if shortcode is invalid

1.1.19

• Option to show a chart of the judge’s values for a dropdown field
• Option to download only the thumbnails, not the larger images
• Some minor display changes and bugfixes

1.1.18

• Fixed some issues with the option for judges to see buttons instead of dropdowns.
• Added a thumbnail-only option to the shortcode, to avoid big downloads if they are not needed.

1.1.17

• Possible fix for a problem some users running older versions of php had with 1.1.16

1.1.16

• Added a “Force Finish” button for each judge to the rating form admin area.
• Tried to give more feedback if a scheme failed to save.
• Added judge option to automatically go to next image after setting a chosen option or checkbox.
• Save the judge page display options for each judge.
• For a rating form, warn if a webform layout does not match the scheme layout.

1.1.15

• Fixed an issue with the “buttons for dropdown” option if the dropdown was used in a restriction.

1.1.14

• Use the new EntryWizard permission to allow downloading of user data.
• Disable dragging of images being judged.
• Some code cleanup.

1.1.13

• Fixed an error in some cases when a user was deleted by someone without full EntryWizard permission.
• When showing ratings from other judges, ignore blank ones if there are more than 5 judges.
• Hide the “buttons for dropdown” option in judge views with no dropdown visible.

1.1.12

• judge option to display buttons instead of dropdowns
• update tables to utf8

1.1.11

• fixed a bug that stopped “User’s Own Images Only” from working in the rating form Item Selection
• updated some code to comply with the latest WordPress changes to timezone handling
• improvement to positioning of the judge help popup
• minor help-text adjustments

1.1.10

• Allow required checkboxes
• Allow a rating form to be created with no judges
• Allow arrow keys to navigate between items on the judging form
• Option to report variance between judges on drop-down fields
• Option to allow a secondary field to override another field in the downloaded spreadsheet
• Warn when saving a scheme with no required field

1.1.9

• requires EntryWizard version 1.3.11
• fixed a bug that allowed changes in the rating_form to lose the “finished” status of judges
• allow setting custom text for no-selection item in option list
• better positioning of error popup near relevant item
• new ‘finish’ parameter in shortcode to control display of “finished” button
• show a toggle indicator on all postboxes
• css changes that may help with some plugin conflicts

1.1.8

• Fix for a problem with the “Finished” button in some cases

1.1.7

• Make the “read” view without “others” parameter show only the judge’s own ratings (NB: to get the original behaviour of the “read” view add ‘ others=”true”‘ to the shortcode).

1.1.6

• Allow “Finished” and “Help” buttons in all views
• Fix for secondary view sometimes not showing some items to all judges
• Increased allowed length of “disqualified items” list
• Keep the “Next” and “Previous” buttons aligned even if the image is resized

1.1.5

• Fix for issues with “Finished” button on judge page

1.1.4

• New “edit rating form” permissions on individual rating forms.
• Allow saving a rating form with no judge so long as it is not open.
• In a new Rating Scheme, the dimensions of the test image now default to the dimensions of the layout’s first image field.
• Display to a user only the rating forms they can edit.
• Several minor code improvements.
• NB: requires version 1.3.8 of EntryWizard

1.1.3

• Fixed a bug in the display of the admin Rating Forms page that appeared in some cases.
• New parameter ‘others’. If “true”, will display ratings from other judges as well as the viewing judge, in all views.
• IMPORTANT: to get the old behavior for view=”read” you will now need view=”read” others=”true”.
• Several other minor tweaks to the user interface.

1.1.2

• Added personal data exporter

1.1.1

• Fixed some issues arising when an item contains more than one image
• When image is downsized, allow the judge to toggle between the full-size view with scrollbars and the resized view
• Allow sorting on columns containing multiple fields
• Some database changes to allow for larger numbers of users and images
• Copy restrictions when copying a scheme
• New interface for selecting judges in the rating form admin area
• In admin areas, use firstname, lastname instead of display_name
• Updated to work with JQuery version 3.0
• Several small tweaks to improve speed and/or user feedback.
• Some changes to improve the view on small devices.

1.1.0

• IMPORTANT: The first time a judge clicks a thumbnail, show them the test image to make sure the window is big enough.
• IMPORTANT: The test image MUST now have the correct dimensions.
• Generate a test image if one is not provided
• Option to allow the judge to resize the image (to a limited extent) in the browser.
• Changes to help text on image sizing.

1.0.14

• Fixed a bug in judge counts when “All Logged-in Users” is selected
• Fixed an issue in the shortcode with the new-item border color
• Fixed scheme creation as copy of existing scheme
• Optional list of disqualified items not to be shown to judges
• Changed user lists to sort by lastname, firstname
• Discourage browsers from using cached images
• Speed up load of admin pages with many rating forms
• Removed the “formatted text” option for text inputs in ratings
• More emphasis in help files on image size and space needed
• Improved feedback in case of missing image files
• Requires EntryWizard version 1.3.3.

1.0.13

• Fixed a possible problem with divided fields if a judge’s name is changed. If you divide fields between judges, DO NOT UPDATE TO THIS VERSION WHILE A RATING FORM IS INCOMPLETE. It may change the allocation of the field to the judges.
• Do not require judge status when allowing “all logged-in users”.
• Made behaviour more consistent on saves of rating forms and schemes.
• In the judge’s help window, more emphasis on reloading the page if anything seems wrong.

1.0.12

• Added batch rating form delete capability
• Saving individual rating forms and schemes no longer completely reloads the page
• Fixed some incompatibilities with the latest version of jquery-ui
• Help text – greater emphasis on ensuring the test image is fully visible in the judge’s window
• Multiple save buttons in rating schemes
• Button to sort rating forms alphabetically
• Judge lists sort by name instead of login
• Earlier versions are not supported with EntryWizard version 1.3.0

1.0.11

• Remind judges if they dont save often enough ( trying to save too much at once can cause data loss )
• Fixed too many characters allowed in identifier input

1.0.10

• Fixed a typo in the documentation re a shortcode parameter name

1.0.9

• Fixed a bug that appeared when a custom display was used for a checkbox or radio layout field that was used in a rating restriction

1.0.8

• Fixed downloaded spreadsheet showing a row for every item in the webform, even if it did not match the item selection criteria
• Show the color-picker properly in a newly-created scheme
• “Read” view now shows “divided” fields to all judges
• New Help page showing all the help popup texts together
• Judges can delete a rating
• Admins can delete a rating if the associated setting is checked
• More checking of shortcode parameters for errors
• Warn on leaving a rating scheme admin page with unsaved changes

1.0.7

• Fixed a problem with the “User’s own images only” option in rating forms under the “read” view.

1.0.6

• Fixed a bug in use of fixed fields in restrictions.
• Fixed validation so a value of “0” is allowed for required items.
• Warn if a non-secondary field is appended to a secondary one.
• Show the save button, etc at the top of the rating scheme as well as at the bottom.

1.0.5

• Fixed a bug that sometimes caused issues when deleting restrictions
• Code cleanup. NOTE: this version requires at least version 1.2.22 of EntryWizard.

1.0.4

• Fixed an issue with sorting in the shortcode.
• Fixed a situation where some admin operations could remove the “Finished” status from a judge.

1.0.3

• Fixed a possible issue with some restriction checking
• Fixed a problem with background colours when there are multiple ewz-rating shortcodes in a page/post
• Added a facility for an admin to see the shortcode (almost) as a judge would see it, without having to log in as the judge.
• Added a choice to the scheme as to whether or not the “Using the Rating Form” button is displayed, and shortened the text of it for the “read” view

1.0.2

• Fixed a bug introduced in 1.0.1 that stopped the image from displaying on a read-only rating page

1.0.1

• Added a facility to create a new scheme as a copy of an existing one.
• Added a facility to change some colours in the shortcode display.
• Fixed a bug that stopped the Rating Shortcodes menu from displaying in a new post or page.
• Use of a color-selection popup instead of a drop-down list.
• Fixed a few other small bugs.
• A number of code changes to facilitate the generation of automated tests. These changes should not have any visible effect.