Available Format Strings for Custom Notifications

For User Notifications, Admin Notifications, Custom message on Form Submission and/or Ranking System the following format strings are available.

  • %NAME% : Will be replaced by the full name of the user.
  • %FNAME%: Will be replaced by the first name of the user.
  • %LNAME%: Will be replaced by the last name of the user.
  • %EMAIL%: Will be replaced by the email address of the user.
  • %PHONE%: Will be replaced by the phone number of the user.
  • %FORMNAME%: Will be replaced by the name of the form.
  • %SITENAME%: Will be replaced by the Website name (Blog name).
  • %TRACK_LINK% : Will be replaced by the raw link from where the user can see the status of his submission.
  • %TRACK% : Will be replaced by a “Click Here” button linked to the track page.
  • %SCORE% : Will be replaced by the score obtained/total score.
  • %OSCORE% : Will be replaced by the score obtained.
  • %MSCORE% : Will be replaced by the total score.
  • %SCOREPERCENT% : Will be replaced by the percentage score obtained, the value is formatted with number_format_i18n.
  • %SCOREPERCENTRAW%: Will be replaced by the float value of percentage. This is rounded to 2 decimal precision.
  • %DESIGNATION% : If the score falls under a valid ranking range, then this will be replaced by the given designation title.
  • %DESIGNATIONMSG% : If the score falls under a valid ranking range, then this will be replaced by the given designation message.
  • %TRACK_ID% : Will be replaced by the Tracking ID of the submission which the user can enter in the track page.
  • %SUBMISSION% : Will be replaced by a printable format of the submission. This has been removed since version 3.4.0. Now individual settings has an option to include submission. It was necessary to increase performance and beautify the email.
  • %SUBMISSION_ID% : Will be replaced by the ID of the submission.
  • %ID%: Will be replaced by the ID of the submission. (Synonymous of %SUBMISSION_ID%).
  • %FORMATTED_ID% : Will be replaced by the formatted ID of the submission.
  • %PORTAL% : Will be replaced by the raw link of the user portal page from where registered users can see all their submissions.
  • %MATH{id}%: Will be replaced by the output of the value of the mathematical element. You need to replace {id} with the numeric key of the mathematical element. For example, %MATH1%, %MATH16% etc. Also Under FORM SETTINGSĀ > FORMAT STRINGS, you need to enable Add format strings for mathematical elements.

With eForm version 4.17, we’ve added the following format strings.

  • %SCORE_PAGE_1% – (String) Gets you a properly formatted score obtained / score total for the relevant page. (eg: 1,000 / 2,145 ).
  • %OSCORE_PAGE_1% – (Float) Gets you the score obtained for the relevant page.
  • %MSCORE_PAGE_1% – (Float) Gets you the maximum score (or “out of” score) of the relevant page.
  • %SCOREPERCENT_PAGE_1% – (String) Gets you properly formatted percentage score (eg: 76.45%).
  • %SCOREPERCENTRAW_PAGE_1% – (Float) Gets you numeric value of percentage score of the relevant page.

Page number starts with 1. So for the fifth page, if you want to get the numeric score, then the format string would be %OSCORE_PAGE_5%.

To make proper usage, make sure you’ve set both the user portal page and trackback page (read: Setup the Trackback Page & User Portal Page). Also, designation related format strings will only work if you have set up the ranking system.

Swashata has written 257 articles

Hi there, I am the Lead Developer at WPQuark.com. I love to create something beautiful for WordPress and here I write about how to use them. When I am not working, usually I am doing a number of other creative things ;).