Support

Home Forums Event Espresso Premium Adding Additional Message Shortcodes

Adding Additional Message Shortcodes

Posted: November 14, 2015 at 7:56 pm


Matthew Breakey

November 14, 2015 at 7:56 pm

Hello,

I’m using Event Espresso as a tool for club members to plan trips with other members. Approved members post a trip and members sign-up (this seems to work just fine). However, most of the options in the custom message builder are set to the [CO_*] family of short codes and do not except any [EVENT_*] family of short codes that:
1) Allow direct communication between event author and sign-ups
2) Clearly identify the event that the communication concerns

How do I add the following short codes; [EVENT_NAME] [EVENT_PHONE] [EVENT_LINK] [EVENT_AUTHOR_FNAME] [EVENT_AUTHOR_LNAME] [EVENT_AUTHOR_FORMATTED_EMAIL] [EVENT_AUTHOR_EMAIL] [DATETIME_START] [TXN_STATUS] [VENUE_URL]; to pretty much all of the message template fields, but the Newsletter in particular as this will be the main method (I believe)?


Tony

  • Support Staff

November 16, 2015 at 3:11 am

Hi Matthew,

The Newsletter message type is a ‘contact’ base messenger.

This means that when you select multiple registrations it pulls in all of the contacts for those registrations, loops over those and sends the newsletter to each contact. At the time of sending the newsletter message does not know which event this was for so it does not currently have access to the Event based shortcodes (which includes datetimes, venues, authors etc as they are all linked using the event itself)

However, most of the options in the custom message builder are set to the [CO_*] family of short codes and do not except any [EVENT_*] family of short codes that:

I’m not sure which sections you are referring to here. The messages use the event author shortcodes for the from fields, so the message should show up as being sent from the event author. Which CO shortcodes do you want to change? Is it the contact details at the bottom of the message?

How do I add the following short codes; [EVENT_NAME] [EVENT_PHONE] [EVENT_LINK] [EVENT_AUTHOR_FNAME] [EVENT_AUTHOR_LNAME] [EVENT_AUTHOR_FORMATTED_EMAIL] [EVENT_AUTHOR_EMAIL] [DATETIME_START] [TXN_STATUS] [VENUE_URL]; to pretty much all of the message template fields, but the Newsletter in particular as this will be the main method (I believe)?

The registration based messages (such as Registration Approved) already include these shortcodes as those message are event based. You can customise these messages and assign a custom message template per event to add more/less details as needed.

Which details are you looking to add and to which message?

1) Allow direct communication between event author and sign-ups
2) Clearly identify the event that the communication concerns

You would need to used the newsletter message type for single custom messages (such as an event reminder or after event follow up), although the event details would need to be manually added to the template when sending the message currently.


Matthew Breakey

November 17, 2015 at 6:29 pm

I have structured my webpage such that
-The webpage (CO_*) email go to IT
-The event authors is the event manager
-Club members sign-up for trips (buy tickets)
Thus, I need a way for event authors to communicate directly with registrants and vice versa. The newsletter is very close to what is needed and the http://www.accyyc.com/wp-admin/admin.php?page=espresso_registrations&event_id=7946 page seems like a great place to manage those registrations.

For this to work, all template messages need to be able to identify
1) The event, which is the case for all but the newsletter
2) The manager/author of the event (name and contact), which is missing from the newsletter and the author’s contact from most of the contact sections of custom messages. For example, the receipt only allows for CO contact information in the header, but not the author who is the manager of the event.


Tony

  • Support Staff

November 18, 2015 at 6:40 am

So is sounds like your basically looking for multiple individual users to create and manage their own events from within a single site, allowing for billing/invoicing on a event manager basis independently from the main organization (so it’s the event manager invoicing the user rather than the main organization) is that correct?


Matthew Breakey

November 18, 2015 at 8:04 am

That is correct. We are a not-for-profit and the majority of events are free, so invoicing is not required. We do have some events such as courses that require invoicing, but the event will still be managed by a designated user. Other than the communication problem and a few custom reporting requirements, EE works well for what we need.


Lorenzo Orlando Caum

  • Support Staff

November 18, 2015 at 9:17 am

Hi Matthew,

Are you also needing invoices on behalf of the designated user (e.g. instructor) or will those invoices be on behalf of your organization?


Lorenzo


Matthew Breakey

November 18, 2015 at 8:51 pm

I’m being difficult, but both. The author/manager is posting the trip on behalf of the organization. Monies are collected on behalf of whoever needs to be reimbursed, the organization in the case of instructional courses and the author/manager in the case of hut bookings. The invoice/receipts message will still have the logo and name of the organization, it is just that the author/manager is the point of contact. The event description can be used to tell registrants who to pay and EE allows the author/manager to check if payment has been received before issuing a “ticket”, which works well for my organization purposes. My primary goal is clear & direct lines of communication.


Tony

  • Support Staff

November 19, 2015 at 5:51 am

Changing the newsletter message type to have the ability to use the Event based shortcodes would need a significant refactor in how that message type works. Its not just a case of allowing additional shortcodes but how the message is generated.

The Newsletter messenger pulls in the contacts from the selected registrations and then loops through and builds each individual message from the contact object. So the messenger receives an array of contacts built from the registrations and and your custom message.

The problem is that a contact does not have a one-to-one relationship with events, a single contact can be assigned to multiple registrations from multiple events. There’s no way to know within the newsletter message type which event you are trying to send a message from (as the event isn’t passed to the messenger) which means event shortcodes can’t work as it is currently.

This is a similar situation for the Invoice/Receipt messengers in that the event_list section is the only section that has the event objects passed to it, which is why you don’t have access to the shortcodes within the main section currently.

The only way around that would be to add your own custom message type and use that, this is not something we can provide support for on the forums, but we do have some developer documentation on this here:

http://developer.eventespresso.com/docs/registering-a-message-type-for-the-messages-system/

We have a ticket for allowing event based shortcodes within the newsletter message system (which would basically be changing the newsletter messenger from a contact base messenger to a registration based messenger) and I will add your thread to that ticket.

The support post ‘Adding Additional Message Shortcodes’ is closed to new replies.

Have a question about this support post? Create a new support post in our support forums and include a link to this existing support post so we can help you.

Event Espresso