Difference between revisions of "Template Modification Tutorial"
(One intermediate revision by the same user not shown) | |||
Line 1: | Line 1: | ||
[[Category:PushMail]] | [[Category:PushMail]] | ||
− | <p>In the following template modification tutorial, the CKeditor will be used in the image examples displayed. Most of the examples will show the ‘WYSIWYG’ display setting, not the ‘Source’ (HTML) setting. As stated in the manual, there are a number of | + | <p>In the following template modification tutorial, the CKeditor will be used in the image examples displayed. Most of the examples will show the ‘WYSIWYG’ display setting, not the ‘Source’ (HTML) setting. As stated in the manual, there are a number of HTML tutorials available online, and one very popular recommended one is at [http://www.w3schools.com/html/ HTML5 Tutorial] if you have a desire to learn some HTML coding.</p> |
<p>As a precursor, we will quickly show you the difference between the WYSIWYG display and the Source display. The WYSIWYG display visually shows the template as one receiving it by email or viewing it in a web browser:</p> | <p>As a precursor, we will quickly show you the difference between the WYSIWYG display and the Source display. The WYSIWYG display visually shows the template as one receiving it by email or viewing it in a web browser:</p> | ||
Line 7: | Line 7: | ||
[[File:Template-Modification-WYSIWYG-display.png|center|frame|link=|WYSIWYG Display]] | [[File:Template-Modification-WYSIWYG-display.png|center|frame|link=|WYSIWYG Display]] | ||
− | The Source display (by clicking on the ‘Source’ button in the upper left icon area) visually shows the template in the | + | The Source display (by clicking on the ‘Source’ button in the upper left icon area) visually shows the template in the HTML coding behind the page. This coding normally includes tables, cells, image/website links, CSS styling, and content text: |
[[File:Template-Modification-Source-display.png|center|frame|link=|Source Display]] | [[File:Template-Modification-Source-display.png|center|frame|link=|Source Display]] | ||
− | For the most part, this tutorial will discuss template modifications in the | + | For the most part, this tutorial will discuss template modifications in the WYSIWYG display setting. |
<pre style="white-space: pre-wrap; | <pre style="white-space: pre-wrap; | ||
white-space: -moz-pre-wrap; | white-space: -moz-pre-wrap; | ||
white-space: -pre-wrap; | white-space: -pre-wrap; | ||
− | white-space: -o-pre-wrap; word-wrap: break-word;">NOTE – | + | white-space: -o-pre-wrap; word-wrap: break-word;">NOTE – The following modifications of a template can be done in either the Templates or Campaigns area. This wiki is two-fold: to show you how to modify templates and to show you why you would use one area or the other to make those modifications.</pre> |
<p>There are two reasons for modifying a template:</p> | <p>There are two reasons for modifying a template:</p> | ||
− | + | *'''Gallery Imports:''' When you import a template into the ‘Gallery’, you will want to make changes that will be used throughout all of your campaigns for that template. For example, a company logo that you want displayed on every campaign. If you don’t make the change here, then every time you create a new campaign with the template, you will have to add the logo. | |
− | + | *'''Campaign-Specific Changes:''' When you create a new campaign, there will always be something you want to possibly add/delete or modify. For example, if you are a real estate agent and have a new listing, you will want to add new text content about that newly listed property and pictures. | |
== Modifying Templates in Email Templates > Templates == | == Modifying Templates in Email Templates > Templates == | ||
Line 31: | Line 31: | ||
[[File:Template-Modification-WYSIWYG-display.png|center|frame|link=|Update Email Template]] | [[File:Template-Modification-WYSIWYG-display.png|center|frame|link=|Update Email Template]] | ||
− | Here | + | Here we're going to make a simple text edit. Use your cursor to highlight ‘About us’ and then type in the title you want. Once you click save, this saves the template so that your name will now appear every time you choose this template for a campaign. |
[[File:Template-Modification-edit-title.png|center|frame|link=|Edit Text inside Template]] | [[File:Template-Modification-edit-title.png|center|frame|link=|Edit Text inside Template]] | ||
− | The next feature to introduce | + | The next feature to introduce is the use of ‘dynamic tags’. Dynamic tags serve two roles: |
=== Tags For Email Content Personalization === | === Tags For Email Content Personalization === | ||
− | <p>By inserting information you already have about your contacts in your lists into your email send. For example, if you have a column header of your subscribers first names titled FNAME, you can start a campaign with a personal “Dear [FNAME],”.</p> | + | <p>By inserting information you already have about your contacts in your lists into your email send. For example, if you have a column header of your subscribers' first names titled FNAME, you can start a campaign with a personal “Dear [FNAME],”.</p> |
− | <p>If the first row of your list has the first name “Lisa”, she would open her email from you and it would begin with “Dear Lisa,”. | + | <p>If the first row of your list has the first name “Lisa”, she would open her email from you and it would begin with “Dear Lisa,”. NOTE: You must make sure that your List column names match the tag names, or the recipient of your email will read “Dear ,”. Thus, every one of your List contacts would receive an email with their first name included.</p> |
− | <p>To extend the use of dynamic tags, if your List has a column with a reason for their contacting you | + | <p>To extend the use of dynamic tags, if your List has a column with a reason for their contacting you (e.g., looking to buy or sell their property titled CONTACT_REASON) and another column with a type of property titled PROPERTY_TYPE, you can send an autoresponse email with an email personalized even further, as in the following example:</p> |
− | <p> Dear [FNAME], thank you for your inquiry concerning [CONTACT_REASON] your [PROPERTY_TYPE].</p> | + | <p>Dear [FNAME], thank you for your inquiry concerning [CONTACT_REASON] your [PROPERTY_TYPE].</p> |
<p>The output they would see upon receipt:</p> | <p>The output they would see upon receipt:</p> | ||
<p>Dear Lisa, thank you for your inquiry concerning selling your condo.</p> | <p>Dear Lisa, thank you for your inquiry concerning selling your condo.</p> | ||
=== Tags For Replace Key Information === | === Tags For Replace Key Information === | ||
+ | |||
<p>Tags also offer an easier way to make changes to all of your templates simply by replacing key information with a tag. For example, if your name is ‘Elizabeth Jones’ in your Account Profile, instead of typing in “Elizabeth Jones” in all of your templates, you can add the tag, [LIST_FROM_NAME]. The tag will pull in your first and last name.</p> | <p>Tags also offer an easier way to make changes to all of your templates simply by replacing key information with a tag. For example, if your name is ‘Elizabeth Jones’ in your Account Profile, instead of typing in “Elizabeth Jones” in all of your templates, you can add the tag, [LIST_FROM_NAME]. The tag will pull in your first and last name.</p> | ||
− | <p>The great thing about this is if you had 30, 50, 100 or more templates and they all needed your name changed, all that would be needed is to change your profile name | + | <p>The great thing about this is if you had 30, 50, 100, or more templates and they all needed your name changed, all that would be needed is to change your profile name. For example, ‘Elizabeth’ changed to ‘Liz’ would change all templates! How convenient is that!</p> |
− | <p> | + | <p>You can view the full list of [[PushMail Tags|tags]].</p> |
== Modifying Templates in ‘Campaigns’ == | == Modifying Templates in ‘Campaigns’ == | ||
− | <p>Click on Campaigns > Campaigns and create a new campaign. At template stage, choose the template you imported into ‘Gallery’. We will begin by editing some of the text as completed in the Templates area.</p> | + | <p>Click on Campaigns > Campaigns and create a new campaign. At the template stage, choose the template you imported into ‘Gallery’. We will begin by editing some of the text as completed in the Templates area.</p> |
− | <p>Replacing text in the WYSIWYG editor is almost as simple as using Word, Notepad or any other text editor with some of the same features of the icons to use. In the modification below, the text has been replaced except for the image titles. NOTE: It is highly recommended during your editing | + | <p>Replacing text in the WYSIWYG editor is almost as simple as using Word, Notepad, or any other text editor, with some of the same features of the icons to use. In the modification below, the text has been replaced except for the image titles. NOTE: It is highly recommended during your editing that you save your template periodically by clicking on the ‘Save template changes’ button below the editor window. You will remain on the page after saving. This will prevent any browser freeze-up from losing your work.</p> |
− | saving. This will prevent any browser freeze up from losing your work.</p> | + | <p>Next, we will add or replace images in our template. Before showing how to add/modify images, the ‘trick’ is to appropriately present your images in the correct width-height that is visually presentable. There are a number of ways to modify the size of your images in a template:</p> |
− | <p> | + | *Crop the image to the size you wish prior to uploading. |
− | *Crop the image to the size you wish prior to uploading | + | *After uploading, and before inserting, change the image size in the Image Properties box. |
− | *After uploading, and before inserting, change the image size in the Image Properties box | + | *After inserting, highlight the image and grab a corner or side anchor and drag to change size. |
− | *After inserting, highlight the image and grab a corner or side anchor and drag to change size | + | *After inserting, highlight the image, right-click on the image, and click on Image Properties. |
− | *After inserting, highlight the image, right click on the image and click on Image Properties | + | *If you know HTML code, change the size in the Source HTML code. |
− | *If you know | + | |
+ | <p>If you do not have a fully featured image program such as Photoshop, there are downloadable programs just for image resizing – [https://imageresizer.codeplex.com/ Image Resizer for Windows] and [http://www.obviousidea.com/windows-software/light-image-resizer/ Light Image Resizer] Another popular online image resizer is [http://www.webresizer.com/resizer/ Web Resizer].</p> | ||
+ | |||
+ | <p>If you want a well-designed program at no cost, the [https://www.gimp.org/ Gimp Image Manipulation Program] should do everything you need for applying your images to templates.</p> | ||
+ | |||
+ | <p>'''Note:''' A word about image preparation, specifically shooting images and cropping. If you are on location and shooting products such as real estate properties, boats, cars, or other items, the temptation is to zoom in and ‘crop’ your image in the lens. I strongly recommend taking a number of pictures with a large amount of space around the product. You’ll find it is much easier to resize/re-crop images at various sizes by having that extra space.</p> | ||
+ | <p>To change existing template images, click on the image with your mouse to highlight it. Delete the image. With the cursor still in the image position you deleted, click on the image icon. The image properties box will be displayed. You must choose your image. Whether your image is on the server already or you need to upload it, you must click on the ‘Browse Server’ button.</p> | ||
+ | |||
+ | [[File:Template-Modification-add-image.png|center|frame|link=|Add Image]] | ||
+ | |||
+ | [[File:Template-Modification-upload-image.png|center|frame|link=|Upload Image]] | ||
− | <p> | + | <p>The Filemanager box will appear with a number of available icon tools. In this example, the image does not exist yet on the server. NOTE: You will be able to create folders for organization under ‘Home’ and any existing files will appear in the main body area. By clicking on the ‘Upload’ icon (at top in red), this will pop up a ‘File Upload’ box. Choose the folder location of the image to upload and double-click on the image to choose it, or highlight it and click open. The image will upload and appear in the main file area. Once in the file area, click on the image.</p> |
− | + | [[File:Template-Modification-insert-image.png|center|frame|link=|Upload Image]] | |
− | + | <p>It now appears in the Image Properties box originally opened. The image will appear in the preview window. Sometimes you may want to modify/add/delete some of the settings here. You can always come back to this properties box.</p> | |
− | + |
Latest revision as of 08:40, 23 July 2024
In the following template modification tutorial, the CKeditor will be used in the image examples displayed. Most of the examples will show the ‘WYSIWYG’ display setting, not the ‘Source’ (HTML) setting. As stated in the manual, there are a number of HTML tutorials available online, and one very popular recommended one is at HTML5 Tutorial if you have a desire to learn some HTML coding.
As a precursor, we will quickly show you the difference between the WYSIWYG display and the Source display. The WYSIWYG display visually shows the template as one receiving it by email or viewing it in a web browser:
The Source display (by clicking on the ‘Source’ button in the upper left icon area) visually shows the template in the HTML coding behind the page. This coding normally includes tables, cells, image/website links, CSS styling, and content text:
For the most part, this tutorial will discuss template modifications in the WYSIWYG display setting.
NOTE – The following modifications of a template can be done in either the Templates or Campaigns area. This wiki is two-fold: to show you how to modify templates and to show you why you would use one area or the other to make those modifications.
There are two reasons for modifying a template:
- Gallery Imports: When you import a template into the ‘Gallery’, you will want to make changes that will be used throughout all of your campaigns for that template. For example, a company logo that you want displayed on every campaign. If you don’t make the change here, then every time you create a new campaign with the template, you will have to add the logo.
- Campaign-Specific Changes: When you create a new campaign, there will always be something you want to possibly add/delete or modify. For example, if you are a real estate agent and have a new listing, you will want to add new text content about that newly listed property and pictures.
Contents
Modifying Templates in Email Templates > Templates
Click on Email Templates > Templates, this takes you to the ‘Email Templates’ page and the template you imported from the Gallery.
Click the ‘Update’ button to open up the template in the CKeditor.
Here we're going to make a simple text edit. Use your cursor to highlight ‘About us’ and then type in the title you want. Once you click save, this saves the template so that your name will now appear every time you choose this template for a campaign.
The next feature to introduce is the use of ‘dynamic tags’. Dynamic tags serve two roles:
Tags For Email Content Personalization
By inserting information you already have about your contacts in your lists into your email send. For example, if you have a column header of your subscribers' first names titled FNAME, you can start a campaign with a personal “Dear [FNAME],”.
If the first row of your list has the first name “Lisa”, she would open her email from you and it would begin with “Dear Lisa,”. NOTE: You must make sure that your List column names match the tag names, or the recipient of your email will read “Dear ,”. Thus, every one of your List contacts would receive an email with their first name included.
To extend the use of dynamic tags, if your List has a column with a reason for their contacting you (e.g., looking to buy or sell their property titled CONTACT_REASON) and another column with a type of property titled PROPERTY_TYPE, you can send an autoresponse email with an email personalized even further, as in the following example:
Dear [FNAME], thank you for your inquiry concerning [CONTACT_REASON] your [PROPERTY_TYPE].
The output they would see upon receipt:
Dear Lisa, thank you for your inquiry concerning selling your condo.
Tags For Replace Key Information
Tags also offer an easier way to make changes to all of your templates simply by replacing key information with a tag. For example, if your name is ‘Elizabeth Jones’ in your Account Profile, instead of typing in “Elizabeth Jones” in all of your templates, you can add the tag, [LIST_FROM_NAME]. The tag will pull in your first and last name.
The great thing about this is if you had 30, 50, 100, or more templates and they all needed your name changed, all that would be needed is to change your profile name. For example, ‘Elizabeth’ changed to ‘Liz’ would change all templates! How convenient is that!
You can view the full list of tags.
Modifying Templates in ‘Campaigns’
Click on Campaigns > Campaigns and create a new campaign. At the template stage, choose the template you imported into ‘Gallery’. We will begin by editing some of the text as completed in the Templates area.
Replacing text in the WYSIWYG editor is almost as simple as using Word, Notepad, or any other text editor, with some of the same features of the icons to use. In the modification below, the text has been replaced except for the image titles. NOTE: It is highly recommended during your editing that you save your template periodically by clicking on the ‘Save template changes’ button below the editor window. You will remain on the page after saving. This will prevent any browser freeze-up from losing your work.
Next, we will add or replace images in our template. Before showing how to add/modify images, the ‘trick’ is to appropriately present your images in the correct width-height that is visually presentable. There are a number of ways to modify the size of your images in a template:
- Crop the image to the size you wish prior to uploading.
- After uploading, and before inserting, change the image size in the Image Properties box.
- After inserting, highlight the image and grab a corner or side anchor and drag to change size.
- After inserting, highlight the image, right-click on the image, and click on Image Properties.
- If you know HTML code, change the size in the Source HTML code.
If you do not have a fully featured image program such as Photoshop, there are downloadable programs just for image resizing – Image Resizer for Windows and Light Image Resizer Another popular online image resizer is Web Resizer.
If you want a well-designed program at no cost, the Gimp Image Manipulation Program should do everything you need for applying your images to templates.
Note: A word about image preparation, specifically shooting images and cropping. If you are on location and shooting products such as real estate properties, boats, cars, or other items, the temptation is to zoom in and ‘crop’ your image in the lens. I strongly recommend taking a number of pictures with a large amount of space around the product. You’ll find it is much easier to resize/re-crop images at various sizes by having that extra space.
To change existing template images, click on the image with your mouse to highlight it. Delete the image. With the cursor still in the image position you deleted, click on the image icon. The image properties box will be displayed. You must choose your image. Whether your image is on the server already or you need to upload it, you must click on the ‘Browse Server’ button.
The Filemanager box will appear with a number of available icon tools. In this example, the image does not exist yet on the server. NOTE: You will be able to create folders for organization under ‘Home’ and any existing files will appear in the main body area. By clicking on the ‘Upload’ icon (at top in red), this will pop up a ‘File Upload’ box. Choose the folder location of the image to upload and double-click on the image to choose it, or highlight it and click open. The image will upload and appear in the main file area. Once in the file area, click on the image.
It now appears in the Image Properties box originally opened. The image will appear in the preview window. Sometimes you may want to modify/add/delete some of the settings here. You can always come back to this properties box.