Food Safety Matrix Tool

v.1

Objective: To develop anonline interactive commodity-location-biosecurity tools matrix. The Food Safety Matrix (FSM) tool will be a focused technical resource, available at the “teachable moment”, to help development practitioners better understand and address potential food safety hazards inherent in production, processing, and storage of specific food commodities. These hazards may affect humans, the environment, or animals. Value chain managers (who in most cases are neither food safety nor infectious disease experts) will be able to efficiently access current resources and quickly put them into practice measures to prevent (or limit) the damage due to pathogens, parasites, or toxins relevant to their commodities.

The FSM web tool will be accessible to authenticated users via Agrilinks.org. and will conform to the new Agrilinks branding elements and style in anticipation of being integrated with the new Agrilinks site when it is launched.

Technical Requirements:

Filters:

The FSM tool will allow users to find information by applying threefilters: Countries, Hazards, and Value Chains.

  • Country. A list of countries containing value chains that are affected by hazards. “Start with a Country” will:
  • Show a list of secondary filter buttons to refine the search by affected Value Chain.
  • Show the affected Hazards applicable for the current Country/VC filter selection.
  • Filter Contacts and Resources by Country.
  • Value Chain. A list of food production areas within countries that are affected by hazards. “Start with a Value Chain” will:
  • Show a list of secondary filter buttons to refine the search by affected Country.
  • Show the affected Hazards applicable for the current Country/VC filter selection.
  • Filter Contacts and Resources by Value Chain.
  • Hazard. A risk to food safety that affects a value chain in a country. “Start with a Hazard” will:
  • Show a list of secondary filter buttons to refine the search by affected Value Chain.
  • Show a list of secondary filter buttons to refine the search by Affected Country.
  • Show the Hazard selected.
  • Filter Contacts and Resources by Hazard.

Common filter tools and behaviors:

  • Primary Filter dropdowns:
  • Selecting the top option from any of the primary filter dropdowns (“Start with . . .”) will clear all filters and reset the tool.
  • Making a selection from one of the primary filter dropdowns will clear any other selected filter options.
  • Until a filter is applied, the tool will show the three most recently added Resources and the three most recently added Contacts.
  • Secondary filters (Affected Countries, Affected Value Chains).
  • Selecting a secondary filter will refine the results to include only content flagged with that filter.
  • When Affected Countries AND Affected Value Chains are available at the same time, making a selection from one list will filter the other list (according to the country-vc-hazard combinations set up in the system).
  • Once a secondary filter is selected, the user can click“Clear Refinements” to return the tool to a state where only the primary filter selected.
  • Users can select from the “Matching Results” dropdown to filter results by type: All, only Contacts, only Resources.
  • Clicking the main “Food Safety Matrix” link will clear all filters.
  • If a null result is returned, a message and button to add content will appear—see “Adding and editing content—end users” below.

Results/Content display:

  • Filtered content will appear below the primary and secondary filter sections.
  • Hazards will display as a gird of tiles, each containing the following elements:
  • Hazard title
  • Thumbnail Image
  • Summary description
  • “Read more” button.
  • Click to see a modal popup of the Hazard page:
  • Title
  • Large image
  • Text area with section titles, text, and Key links (URLs)
  • 2 sidebar blocks:
  • Countries affected will show all of the countries from the county-vc-hazard combinations that include the hazard
  • Value chains affected will show all of the value chains from the county-vc-hazard combinations that include the hazard
  • “X” button will allow the user to collapse the modal and return to the filter tool.
  • Contacts will display as a grid of tiles, each containing the following elements:
  • Contact Title
  • URL
  • Edit this contact link will appear below the tile for the author of that contact only.
  • Resources will display as a grid of tiles, each containing the following elements:
  • Resource Title
  • Description
  • Organization
  • View Resource button will expand the tile to show a list of resources, URLs and Attachments, with an icon indicating whether each is an icon or an attachment by attachment type (PDF, DOC, etc.).

Managing the filter tool:

  • The FSM tool filters content according to the country-vc-hazard combinations set up in the system. This is to prevent invalid combinations from being added to the system (e.g., value chains that do not apply to countries, hazards that do not apply to value chains, etc.)
  • All Contacts and Resources must be associated with at least one country-vc-hazard combination. This is to prevent “orphaned content” that cannot be found with all three filters applied.
  • Only site admins will be able to create new country-vc-hazard combinations. Users must contact editorial staff to request a new combination.

Adding and editing content—end users:

  • End users will be able to submit two types of content: Contacts and Resources.
  • Buttons for adding content will appear in the filter results areas.
  • “Resources” legend will be accompanied by a “Post a Resource” button
  • If a search for Resources returns a null result, a “Post a Resource” button will display in the empty tile area, along with the message: “Sorry, there are no resources available for this request. Do you have a resource to contribute?”
  • “Contacts” legend will be accompanied by a “Post a Contact” button
  • If a search for Contacts returns a null result, a “Post a Contact” button will display in the empty tile area, along with the message: “Sorry, there are no contacts available for this request. Do you have a contact to contribute?”
  • Content submitted by users is not immediately published, but goes into an approval queue. Upon submitting the content, a message will display instructing the user how the approval process works. “Thanks for submitting content to the Food Safety Matrix. Your post will be reviewed by an Agrilinks editor before publication. If there are questions, our editor will contact you at the email address associated with your account.”
  • End users will be able to edit published content they have submitted. Upon doing so, the content will be unpublished from the site and added to the approval queue.
  • Users will see pink-colored tiles indicating which have been submitted but not published.
  • Once published, a tile authored by the logged in user will display a link to edit that content.
  • When content is submitted by a user, a notification email fires off to the FSMCA group.

Approving content—FSMCA users:

  • Only users with the role of “food safety matrix content admin”(FSMCA) will be able to publish content.
  • Upon logging in, FSMCA users will see a message “Content Awaiting Approval. Click here to view.”
  • Clicking the link displays a list of unpublished content, including type, title, Updated date, author, and a checkbox to select items from the list.
  • A publish button will allow FSMCA users to bulk publish content.
  • Clicking on a link will open the item for review.
  • FSMCA user can edit and save the item per standard drupal process.
  • Published checkbox must be checked before saving in order to publish the page.

An Additional Food Safety Assets menu will display at the bottom of the tool. It will list links as follows, with each link accompanied by a graphical icon:

  • Glossary of terms doc will link to /glossary-of-terms page.
  • Key links will link to /key-links page.
  • E-learning opportunities will link to /e-learning-opportunities page.
  • Suggested Twitter resources will link to /suggested-twitter-resources page.
  • Suggested YouTube videos will link to /suggested-youtube-videos page.