RATEREMINDMAIL- (Rating reminder) - WEBSALE Dokumentation

After delivery, the shop can remind the buyer by email to rate the purchased products. Whether they want such a reminder is up to the buyer, and they decide this on the order overview page ws_place_order.htm. The RATEREMINDMAIL- tags build this selection. They return the names for the checkbox and the hidden field and answer the question of whether there is already an earlier decision by the buyer on which the preselection can be based. Guide: Description of the product rating module

All tags on this page apply exclusively on the order overview page ws_place_order.htm and belong within the order form.

The two form fields

The selection consists of two elements: a checkbox that the buyer sees and a hidden field in which the decision is passed.

Tag	Returns
`RATEREMINDMAIL-Name`	the name of the checkbox
`RATEREMINDMAIL-Hidden_name`	the name of the hidden field
`RATEREMINDMAIL-Hidden_value`	the value of the hidden field

<form action="~FORM-PlaceOrder~" method="post">
   <input type="hidden" name="~RATEREMINDMAIL-Hidden_name~" value="~RATEREMINDMAIL-Hidden_value~">

   <label>
      <input type="checkbox" name="~RATEREMINDMAIL-Name~">
      Erinnern Sie mich daran, die bestellten Produkte zu bewerten.
   </label>
</form>

The hidden field belongs in the same form as the checkbox. The shop system adopts the buyer’s decision via this field. If it is missing, the state of the checkbox has no effect.

All three tags are exclusively single tags.

Adopting the earlier decision

If the buyer has already answered the question, the checkbox should show this instead of asking again. There are two sources for this: the current session and the last order.

Tag	Answers
`RATEREMINDMAIL-UserSelectedSession`	Has the buyer already decided in this session?
`RATEREMINDMAIL-UserSelectionSession`	How did they decide in this session?
`RATEREMINDMAIL-UserLastorderExists`	Is there a decision from the last order?
`RATEREMINDMAIL-UserLastOrderSelection`	How did they decide back then?

As single tags, the two Selection tags output either checked or nothing. You therefore place them directly in the input element.

<form action="~FORM-PlaceOrder~" method="post">
   <input type="hidden" name="~RATEREMINDMAIL-Hidden_name~" value="~RATEREMINDMAIL-Hidden_value~">

   {RATEREMINDMAIL-UserSelectedSession}
      <input type="checkbox" name="~RATEREMINDMAIL-Name~" ~RATEREMINDMAIL-UserSelectionSession~>
   {/RATEREMINDMAIL-UserSelectedSession}

   {!RATEREMINDMAIL-UserSelectedSession}
      {RATEREMINDMAIL-UserLastorderExists}
         <input type="checkbox" name="~RATEREMINDMAIL-Name~" ~RATEREMINDMAIL-UserLastOrderSelection~>
      {/RATEREMINDMAIL-UserLastorderExists}

      {!RATEREMINDMAIL-UserLastorderExists}
         <input type="checkbox" name="~RATEREMINDMAIL-Name~">
      {/!RATEREMINDMAIL-UserLastorderExists}
   {/!RATEREMINDMAIL-UserLastorderExists}
</form>

The order in the example is deliberate: the decision from the current session is the more recent one and therefore takes precedence over the one from the last order. If there is no decision at all, the checkbox remains in its initial state.

RATEREMINDMAIL-UserSelectionSession belongs within RATEREMINDMAIL-UserSelectedSession, RATEREMINDMAIL-UserLastOrderSelection within RATEREMINDMAIL-UserLastorderExists. Without the respective range, an empty result cannot be distinguished from a missing decision.

Note the spelling: UserLastorderExists with a lowercase o, UserLastOrderSelection with a capital O. The two tag names are inconsistent at this point.

The tags at a glance

Tag	Single tag	Range tag	Negative range tag	Loop tag
`RATEREMINDMAIL-Name`	yes	–	–	–
`RATEREMINDMAIL-Hidden_name`	yes	–	–	–
`RATEREMINDMAIL-Hidden_value`	yes	–	–	–
`RATEREMINDMAIL-UserSelectedSession`	–	yes	yes	–
`RATEREMINDMAIL-UserSelectionSession`	yes	yes	yes	–
`RATEREMINDMAIL-UserLastorderExists`	–	yes	yes	–
`RATEREMINDMAIL-UserLastOrderSelection`	yes	yes	yes	–

All tags apply exclusively on the order overview page ws_place_order.htm. The two Selection tags are each placed within their corresponding range.

Guide: Description of the product rating module
Reference: PRODRATING- (Submitting and confirming a rating)
Reference: FORM- (Forms)

​The two form fields

​Adopting the earlier decision

​The tags at a glance

​Related topics

The two form fields

Adopting the earlier decision

The tags at a glance

Related topics