Enabling the Feedback form

As of April 2019, Numishare includes a Feedback form, validated with reCAPTCHA v2 (requires Orbeon 2017.2.2 or later), to prevent spam by robots. If you are using a Numishare version installed prior to this date, then you should sync your code to the Numishare master branch and insert the following configuration into your Numishare config.xml, in the pages element:

<feedback enabled="false">
	<smtp-host>localhost</smtp-host>
	<to type="">
		<email></email>
		<name></name>
	</to>
	<recipient-types>
		<type>curatorial</type>
		<type>technical</type>
	</recipient-types>
	<feedback-types>
		<type type="curatorial">Cataloging error</type>
		<type type="curatorial|technical">Comment or suggestion</type>
		<type type="technical">Interface bug</type>					
		<type type="curatorial">Other</type>
	</feedback-types>
</feedback>

In order to activate the feedback form, you will need to follow the following instructions:

• Ensure that you have installed a mail server (like postfix) onto your server or that you have access to an external one that you can set in the Numishare config.
• Review the Orbeon documentation for the Captcha feature. You will need to create a reCAPTCHA account with Google under your domain name to get a public and private key that need to be set in the Orbeon properties-local.xml, as per the instructions above.
• You will need to go to the Settings page in the Numishare Admin panel for your collection in order to set the mail server configuration. On the left hand navigation menu, click "Page Content and Navigation". This new interface allows you to check which pages/navigation tabs should be enabled in Numishare. Some pages are restricted by the type of collection. Enable the Feedback tab.
  • By default the smtp-host is set to localhost, but this can be changed.
  • Set the recipient name, email address, and type (technical or curatorial staff). More than one possible recipient can be set for these categories.
  • Different categories of feedback (e.g., bugs, cataloging errors, etc.) can be set, and they will appear as drop down menu items in the feedback form user interface. The category of feedback affects the potential recipient list. Some types of feedback can go to technical and curatorial recipients simultaneously.
  • After the minimum configuration is set and the form is valid, click the Save button to save the config. After these settings are enabled and validated, the link to the Feedback form will appear in the Numishare navigation tabs.