CiviCRM Community Forums (archive)

*

News:

Have a question about CiviCRM?
Get it answered quickly at the new
CiviCRM Stack Exchange Q+A site
This forum was archived on 25 November 2017. Learn more.
How to get involved.
What to do if you think you've found a bug.



  • CiviCRM Community Forums (archive) »
  • Old sections (read-only, deprecated) »
  • Support »
  • Using CiviCRM »
  • Using CiviMail (Moderator: Piotr Szotkowski) »
  • Documentation on Action Tokens
Pages: [1]

Author Topic: Documentation on Action Tokens  (Read 1996 times)

Dennis Gray

  • Ask me questions
  • ****
  • Posts: 472
  • Karma: 1
  • CiviCRM version: Various. See post.
  • CMS version: Drupal, Wordpress and Joomla. See post.
  • MySQL version: TBA
  • PHP version: TBA
Documentation on Action Tokens
January 04, 2008, 03:15:01 pm
http://wiki.civicrm.org/confluence/display/CRMDOC/CiviMail+Action+Tokens is a link to a table which describes action tokens. Is there any more documentation on this topic? Specifically,

  • Where are the values for action tokens set? There are many more tokens than there fields in the domain settings.
  • When I use an action token in a test mailing {action.optOut}, I get a very long email address, such as mailto:optOut.1.7.477.005482258b41a7b4005c55a29f06d77b1bba4641@fareast.com.au. This obviously is not a correct address. As in my first point, where are these values set?

Many thanks

Donald Lobo

  • Administrator
  • I’m (like) Lobo ;)
  • *****
  • Posts: 15963
  • Karma: 470
    • CiviCRM site
  • CiviCRM version: 4.2+
  • CMS version: Drupal 7, Joomla 2.5+
  • MySQL version: 5.5.x
  • PHP version: 5.4.x
Re: Documentation on Action Tokens
January 04, 2008, 05:04:06 pm

1. The values are primarily set in CRM/Mailing/BAO/Mailing.php (function getVerpAndUrlsAndHeaders)

2. Why is this not a correct address? Can you back up your assertion with a link to an RFC or standards document?

the format is: KEY.DOMAIN_ID.JOB_ID.QUEUE_ID.HASH@DOMAIN_EMAIL

lobo
A new CiviCRM Q&A resource needs YOUR help to get started. Visit our StackExchange proposed site, sign up and vote on 5 questions

Dennis Gray

  • Ask me questions
  • ****
  • Posts: 472
  • Karma: 1
  • CiviCRM version: Various. See post.
  • CMS version: Drupal, Wordpress and Joomla. See post.
  • MySQL version: TBA
  • PHP version: TBA
Re: Documentation on Action Tokens
January 05, 2008, 03:16:49 am
It's not a correct address because I didn't set the value in the Mailing.php but how was I supposed to know that I had to do that? In order to user CiviMail am I expected to read all the code?

Donald Lobo

  • Administrator
  • I’m (like) Lobo ;)
  • *****
  • Posts: 15963
  • Karma: 470
    • CiviCRM site
  • CiviCRM version: 4.2+
  • CMS version: Drupal 7, Joomla 2.5+
  • MySQL version: 5.5.x
  • PHP version: 5.4.x
Re: Documentation on Action Tokens
January 05, 2008, 06:50:05 am

I dont think i understand what you mean by the below? you might want to rephrase it in a different manner

No, we dont expect people to read civimail code to use it, but you are more than welcome to do so and document / provide patches for various bugs and issues :)

lobo
A new CiviCRM Q&A resource needs YOUR help to get started. Visit our StackExchange proposed site, sign up and vote on 5 questions

twowheeler

  • I post occasionally
  • **
  • Posts: 115
  • Karma: 11
    • Harrisburg Christian Performing Arts Center
  • CiviCRM version: 4.3.4
  • CMS version: Drupal 7.22
  • MySQL version: 5.1
  • PHP version: 5.3
Re: Documentation on Action Tokens
January 05, 2008, 07:23:53 am
Ozyank,
It sounds like there might be a misunderstanding here.  Those strange URLs are created by CiviMail to enable click through tracking and similar features.  Your server is notified that the recipient has opened the email, or clicked on an image so it can keep track of such events.  The long string in the URL identifies the particular recipient of the email so that CiviMail can track that individual.  In other words, it is a feature, not a bug, and I can testify that it works.  If you don't like this, you can turn off click through tracking in the CiviMail interface.

Hope that helps.

Dennis Gray

  • Ask me questions
  • ****
  • Posts: 472
  • Karma: 1
  • CiviCRM version: Various. See post.
  • CMS version: Drupal, Wordpress and Joomla. See post.
  • MySQL version: TBA
  • PHP version: TBA
Re: Documentation on Action Tokens
January 05, 2008, 12:02:27 pm
If the user receives a mail that says he or she can unsubscribe and then clicks on the link, his or her email client will open using that email address, which is not a valid address on my email server.

The part I don't understand is how to relate a real email address to the unsubscribe, opt-out, etc. action tokens.

Dennis Gray

  • Ask me questions
  • ****
  • Posts: 472
  • Karma: 1
  • CiviCRM version: Various. See post.
  • CMS version: Drupal, Wordpress and Joomla. See post.
  • MySQL version: TBA
  • PHP version: TBA
Re: Documentation on Action Tokens
January 05, 2008, 04:42:36 pm
I've received some direct replies and think I understand how this all works now.

Thanks for your responses.

Dennis
Pages: [1]
  • CiviCRM Community Forums (archive) »
  • Old sections (read-only, deprecated) »
  • Support »
  • Using CiviCRM »
  • Using CiviMail (Moderator: Piotr Szotkowski) »
  • Documentation on Action Tokens

This forum was archived on 2017-11-26.