Creating your own newsletter template

From Sendcockpit

Jump to:navigation, search
If you program your newsletter template by yourself, we cannot provide free support for HTML coding or display optimization support for e-mail clients. We can, of course, create a customized template for you. Just get in touch.
Warning


Contents

Introduction

Find out how to create your own e-mail templates. See the template administration function in the main menu under Account under the Mailing Templates tab.


You can also copy and modify existing templates. Therefore we give you full access to the source code of all templates designed by us. This lets you adapt our standard templates to your own requirements. Find out more.
Info

Source code sample template

Download source codes for sample templates. Please also download this file for a better understanding of the information below, which often refers back to this info.
Download

The principle of elements

In the simplest case, a template consists of plain HTML source code. However, it can also include special placeholders, called elements. When you use templates, elements let you edit the content easily with our editor.

The three elements, with examples of integration

Text elements

Text elements only let you modify text later on in the editor. The format is already specified.

<chamtxt linkstyle="text-decoration:none;">A text element</chamtxt>

HTML element

HTML elements also let you adapt the formatting and alignment in our WYSIWYG editor.

<chamhtml>A HTML element</chamhtml>

Image Element

Image elements let users upload and import their own pictures using the editor.

<chamimg><img class="cham_img" width="100"></chamimg>

Sections that can and can’t be edited

Open the quellcode.txt file with a text editor. This file forms the backbone of the template. It contains plain HTML code, as well as the elements described above.
Info

Sections that cannot be edited using the editor

Areas that are permanently integrated in the template and are not be modified with the editor are entered directly as HTML code. For example, see line 15 for an image that is an integral part of the template.

Sections that should be able to be edited using the editor

Lines 21 and 22, however, include a text element enclosed by the cham placeholder text. The design of this text element is predefined in the TD and cannot be changed later in the editor. The placeholder contains predefined text. You can click on this later on in the editor and change it to your requirements. You can also insert HTML and image elements anywhere you like, and these can be also changed in the editor.

The module principle

Modules are no more than HTML snippets that users can insert later dynamically in the editor at certain points in the template. Modules can therefore contain plain HTML source code, and optionally one or more of the above elements. You can create as many different modules as you like in your user account.

Placing modules in source code

For the editor to know where users can insert modules, mark this in the source code as follows:

<chammodule>

Nested modules

Nested modules are also possible. Module placeholders can be installed both in the main source (quellcode.txt) and in the modules themselves. You could therefore insert the <chammodule> module placeholder in the image gallery, to insert a image module, for example. To let the editor know that the image module can only be inserted in the image gallery, designate the module as follows:

Image Gallery::Image

What is the difference between modules and elements?

Elements are contents that users can change in the editor (text, HTML or images). A module, on the other hand, is a combination of conventional HTML and dynamic content, meaning it can consist of several elements.Modules can also be moved. If users, for example, insert an editorial module and several article modules in a module placeholder, they can then change the sequence as they wish using drag and drop.

Storing and using image files

To store image files (no image elements), you can use your own server and simply link accordingly, e.g. http://www.yourdomain.com/images/image1.jpg. We can also host images for you. Send us a short message with the images and the ID of the template to: support@sendcockpit.com. Please then insert the images as follows:

<img src="§§tpl_img_path§§/image.jpg">

Formatting hyperlinks

CSS information must always be defined inline. Some freemailers ignore formatting defined in the header. The template definition therefore includes a hyperlink style text field. All CSS entries made here are automatically adapted for each a-tag in the mailing. Example:

color:#a93f28; text-decoration:none;

Using placeholders

You can use different placeholders in the template: Read more.

Miscellaneous

Can I pre-assign other elements with content?

Yes, you can. For text and HTML elements, see examples above in the section on the three elements. For the image element, just enter the src attribute for the image file’s path

Why is my data ignored in the header section?

The first time you save a mailing in the mailing editor, everything in your code above <body> is replaced by a standard that ensures consistent display and encoding (UTF-8) of the mailing. Regardless of this, some freemailers ignore CSS values written inline.

See also

Categories
In other languages