bigfish BF Admin Mdule Manage Email.dc Last Updated: 19-Nv-2013 1
TABLE OF CONTENTS 1 Mdificatin Histry...3 2 Manage Email...4 2.1 List Screen...4 2.2 References...4 3 Email Templates...5 3.1 Technical Nte...5 3.2 List Screen...5 3.3 Detail Screen...6 4 Email Cnfiguratin...8 4.1 Technical Nte...8 4.2 List Screen...8 4.3 Detail Screen...8 4.4 Technical Nte...10 5 Text Message Templates...11 5.1 Technical Nte...11 5.2 List Screen...11 5.3 Detail Screen...11 6 Email Parameters...13 6.1 Prcessing...13 2
1 Mdificatin Histry Date Wh Cmments 24-Aug-11 Slveda Split frm BF Admin Mdule Admin dcument 17-Oct-12 Slveda Links t Email Test cmpnent 26-Feb-13 Slveda Added text messaging capability 9-Oct-13 Slveda Ability t add a new Email r TXT template 19-Nv-13 Slveda Added status t email Cnfiguratin 4-Apr-14 Slveda Added File vs Embedded cntent 3
2 Manage Email 2.1 List Screen manage email and text messages Manage Email Functin Email Templates Email Cnfiguratin Text Message Templates Email Parameters Descriptin Manage Email Templates that are used in all utging emails Manage the Frm, T and ther attributes f utging emails Manage Text Messaging Templates used in ntificatins t cell phnes Standard parameters used primarily fr styling the email cntent 2.2 References Als see spec BF Email.dc 4
3 Email Templates 3.1 Technical Nte OFBiz Entity: CONTENT Cntent-ID = E_xxxxx Cntent-Type-ID = BF_EMAIL_TEMPLATE Nte: see the BF-Admin-Mdule-Cntent.dc spec fr details n managing the separatin f cntent by PRODUCT_STORE 3.2 List Screen email templates list Email Templates Cntent ID Email Name Status Descriptin Active Date Created Date E_COMMON_STYLES Cmmn Styling Active This is the generic 08/01/11 07/27/11 styling fr all emails. E_COMMON_HEADER Cmmn Header Active This is the standard 08/02/11 07/27/11 header definitin fr all utging emails. E_COMMON_FOOTER Cmmn Fter Active This is the standard 08/02/11 07/29/11 fter definitin fr all utging emails. E_NEW_CUSTOMER New Custmer Active New user email that is 08/03/11 08/01/11 sent whenever a new custmer registers at yur site. E_FORGOT_PASSWORD Frgt Passwrd Active Sent when a custmer 08/03/11 08/01/11 clicks n the Frgt Passwrd link E_REQUEST_CATALOG Request Catalg Active Request Catalg 08/03/11 08/02/13 E_ETC Anther Email Active Email Etc 08/03/11 08/02/12 Add Template Srt Sequence: Cntent ID Clicking n the Cntent ID link will pass cntrl t the Detail Screen Add Template Redirect t the Detail Screen in add mde Actin Tltip is Test Email This will pass cntrl t the Email Test functin as described in the spec BF Admin Mdule Tls.dc 5
3.3 Detail Screen email templates detail Cntent Detail: EMAIL_CHANGE_CUSTOMER Cntent ID: Name: Descriptin: EMAIL_CHANGE_CUSTOMER Change Custmer email Sent whenever yur custmers update their persnal prfile. * 255 character limit (n characters left) Type: Cntent: Embedded File Reference <html> <sme tag> </sme tag> </html> Created Date: 07/27/11 at 9:00am Status: Active Set t Inactive Active Date: 08/01/2011 at 3:00pm Save Add Mde Cntent ID is an editable field Must cnfrm t an ID, see spec BF Admin Mdule General.dc Characters left cuntdwn Descriptin is limited t 255 characters Embedded vs File Reference See spec BF Admin Mdule Cntent fr prcessing rules Save message. Yur changes t [email-name] have been saved, return t List Screen Validatin: Name cannt be blank Errr: The Name field cannt be blank Descriptin cannt be blank 6
Errr: The Descriptin field cannt be blank Email Cntent cannt be blank Errr: The Email Cntent field cannt be blank 7
4 Email Cnfiguratin 4.1 Technical Nte OFBiz Entity PRODUCT_STORE_EMAIL_SETTING ENUMERATION, ENUM_TYPE_ID = PARTY_EMAIL Multi-Stre Cnsideratin: Fr Multi Stre implementatins, the maintenance f the Email Cnfiguratins file needs t cnsider the active stre 4.2 List Screen email cnfiguratin list Email Cnfiguratin Email Type Status Descriptin Subject Frm PRDS_CUST_REGIST Active Custmer Registratin Client.cm: Thank yu csr@client.cm PRDS_ABD_CART Active Abandned Cart Check yur cart! csr@client.cm ETC Active ETC etc! etc@client.cm Srt Sequence: Email Type Actin This will prvide additinal infrmatin as well as indicate which templates are assciated with the cnfiguratin item Users may click n an email-template, this will pass cntrl t the apprpriate email template detail screen Example: CC: csr-cpy@client.cm BCC: csr-blind@client.cm Email Templates Used: E_HEADER E_ORDER_DETAIL E_FOOTER 4.3 Detail Screen email cnfiguratin detail Email Detail: Custmer Registratin 8
Email Type: Descriptin: PRDS_CUST_REGISTER Custmer Registratin * 255 character limit (n characters left) Subject: Frm: CC: BCC: Created Date: Client.cm: Thank yu fr registering! custserv@client.cm ccntify@client.cm bccntify@client.cm 07/27/11 at 9:00am Status: Active Set t Inactive Active Date: 08/01/2011 at 3:00pm Save Characters left cuntdwn Descriptin is limited t 255 characters Frm must be a valid frmat email CC and BCC fields can cntain multiple email addresses by using a, separatr. All email addresses shuld be prperly frmatted emails. Save message. Yur changes t [email-name] have been saved, return t List Screen Validatin: Frm: Must be a valid email address: The FROM field must cntain a valid email address Can nly be ONE address: The FROM field can nly cntain a single email address CC valid frmat emails Errr: The CC field must cntain valid email addresses. Yu can use the, separatr fr multiple email addresses BCC valid frmat emails Errr: The BCC field must cntain valid email addresses. Yu can use the, separatr fr multiple email addresses Frm cannt be blank Errr: The Frm field cannt be blank Subject cannt be blank Errr: The Subject field cannt be blank 9
4.4 Helper Text Fr CC and BCC : T enter multiple emails use a cmma (,) delimiter 4.5 Technical Nte T accmmdate the Active/Inactive a custm extensin will be added t the Ofbiz Entity PRODUCT_STORE_EMAIL_SETTING: STATUS_ID [related t STATUS_ITEM.CONTENT_STATUS] 10
5 Text Message Templates 5.1 Technical Nte OFBiz Entity: CONTENT Cntent-ID = TXT_xxxxx Cntent-Type-ID = BF_TXT_TEMPLATE Nte: see the BF-Admin-Mdule-Cntent spec fr details n managing the separatin f cntent by PRODUCT_STORE 5.2 List Screen text message templates list Text Message Templates Cntent ID Text Name Status Descriptin TXT_ABANDON_CART Abandned Cart Active Abandned Cart Text Message template TXT_NEW_CUSTOMER New Custmer Active New Custmer Text Message template TXT_ORDER_CHANGE Order Change Active Order Change Text Message template TXT_ORDER_CONFIRM Order Cnfirm Active Order Cnfirm Text Message template TXT_FORGOT_PASSWORD Frgt Passwrd Active Frgt Passwrd Text Message template TXT_SHIP_REVIEW Review Active Review Text Message template TXT_CHANGE_CUSTOMER Change Custmer Active Change CustmerText Message template Active Date Created Date 08/01/11 07/27/11 08/02/11 07/27/11 08/02/11 07/29/11 08/03/11 08/01/11 08/03/11 08/01/11 08/03/11 08/02/13 08/03/11 08/02/12 Add Template Srt Sequence: Cntent ID Clicking n the Cntent ID link will pass cntrl t the Detail Screen Add Template Redirect t the Detail Screen in add mde Actin Tltip is Test Text Message This will pass cntrl t the Text Test functin as described in the spec BF Admin Mdule Tls.dc 5.3 Detail Screen 11
text message templates detail Cntent Detail: TXT_ORDER_CONFIRM Cntent ID: Name: Descriptin: TXT_ORDER_CONFIRM Order Cnfirm Order Cnfirm Text Message * 255 character limit (n characters left) Type: Cntent: Embedded File Reference Yur Order {$ORDER_NO} is cnfirmed fr {$TOTAL_AMOUNT} * 160 character limit (n characters left) Created Date: 07/27/11 at 9:00am Status: Active Set t Inactive Active Date: 08/01/2011 at 3:00pm Save Add Mde Cntent ID is an editable field Must cnfrm t an ID, see spec BF Admin Mdule General.dc Characters left cuntdwn Descriptin is limited t 255 characters Embedded vs File Reference See spec BF Admin Mdule Cntent fr prcessing rules Save message. Yur changes t [email-name] have been saved, return t List Screen Validatin: Name cannt be blank Errr: The Name field cannt be blank Descriptin cannt be blank Errr: The Descriptin field cannt be blank Email Cntent cannt be blank Errr: The Email Cntent field cannt be blank 12
6 Email Parameters 6.1 Prcessing This will prvide a redirect t the general BigFish Parameter screen See the BigFish Parameters sectin in the spec BF Admin Mdule Tls.dc 13