MODIFYING THE JFCK TEXT EDITOR TO USE TAGS

In order to use tags with the JFCK editor, you will need to make a slight modification to its code. This bug might occur using the JoomlaFCK Editor. The bug has already been reported to the JoomlaFCK team, we hope they will fix it in the next version but you can fix it immediately on your own website :

In the file Yourwebsite/Joomla/plugins/editors/fckeditor.class.php, on line 74 (actually it is line 84)  you should find the function :

function onSetContent( $editor, $html ) { 
return " oFCKeditor.InsertHtml = '" .  htmlentities($html) . "'; 
alert('".$html."');"; 
}

WAS ACTUALLY:

function onSetContent( $editor, $html ) {

                        return " oFCKeditor.InsertHtml = '" .  htmlentities($html) . "'";

            }

which should be replaced by :

function onSetContent( $editor, $html) { 
return " FCKeditorAPI.GetInstance('$editor').SetHTML( $html ); "; 
}

Changes: deletes the small o, adds API, adds GetInstances and rest

 

ADDING TAGS TO YOUR NEWSLETTER

If you would like to further customize your newsletters, there is a whole section of tags you can add. Open up a newsletter and click on the TAG at the top of the page.  One of the best feature in AcyMailing is its ability to include personal information in the Newsletter so each user will receive HIS Newsletter and not a generic one. Click on the button Tags

 

 

A popup will open and you will see a list of information you can use in your Newsletter

You can insert personal information which will be replaced during the send process like the name of the user for example, or a personal link to enable your users to unsubscribe from your Newsletter...

Click on the menu Subscriber to be able to access the subscriber information and insert your personal tag

 

 

 

Click on the field Name.

 

 

 

You should see immediately the tag {subtag:name} inserted in your Newsletter, where your cursor was.

 

 

AcyMailing is integrated with several other components so the same way, you will be able to insert Joomla Content, Events, Products, Coupon Discounts or even a Joomla Module! (depending on your AcyMailing version)

 

If you insert a tag in your Newsletter which is not a personal tag (Content, Events, Products...), this tag will be also replaced during the send process and on the preview page.

But if you want to modify it, you can click on the button Replace Tags which will replace the tag by the real content so you will be able to modify the inserted content the way you want before sending your Newsletter.

 

 

By default, the Unsubscribe Tag is already active. Next click on the Subscriber Tab:

 

 

The row you are most likely to use is the “First Part of subscriber’s name”

 

Click on Joomla Content: Here you can write separate Joomla articles and then link the INTROS to the ones you want to your newsletter. This is really a fantastic option if you will be sending out regular newsletters and you want to link them to articles on your website:

 

 

 

Using Tags to insert a Joomla article into your Newsletter

We have to insert a tag that will tell the system to insert your article. A tag is just a piece of code that is inserted into your newsletter that will be replaced by some type of content when it sends. Rather than copying and pasting text, you can insert article tags, save your newsletter, and go back to make changes in any of your articles; the text changes will automatically be updated when you send.

First, click your cursor in the edit window where you want your article to show up. Then click "Tags" up at the top. (See diagram below)

 

 

 The Tags Selector

The next window to appear will be your Tags Selector. Each tab across the top will bring up options (tags) you can inset into your newsletter. The tab, "Subscription" will bring up tags that you can insert such as: user name, name, email. For this section, we just want to add an article, click on "Joomla Content." (see diagram below)

 

 

 

Article Insertion Choices

This next window allows you to make some choices in how your article will eventually appear. The first thing you will want to do is find your article. On the right, you will see a pull-down menu that defaults to "all." This shows ALL articles on your site. You can quickly filter out the section/category by opening this menu and picking the appropriate category. Or if you know your title, you can type the entire title or partial title into the "Filter" box on the left and press "Go." this will search your articles for whatever you just typed.

Once you have found your article, just click the title. Automatic code will be generated, and your selection will turn pale orange. (see diagram below)

 

 

 

All you need to do is decide if you want to show the Intro text or the full text. Intro text is all the text in an article before you press the "read more" button in the Joomla article manager edit window. You can also chose whether or not to show the author name or make the title clickable. If you chose this option, the article title will automatically take the reader back to your site to read that article on your website.

Once you've made all your selections, just click "Insert the tag."In this case, a small piece of code is automatically inserted into your newsletter edit window. (see diagram below)

 

 

Plugin: Joomla Content

This plugin enables you to include in your Newsletter one or several Joomla Articles.

You will be able to filter and search in your articles, select one or several articles at the same time and then insert them in your Newsletter.

A simple tag will be inserted and you will be able to see the result if you preview your Newsletter.

Once you inserted your tag, you can click on the button "Replace Tags" in order to replace the inserted tag by the corresponding article.

 

Click on one of your article to select it, you can click again in order to deselect it or click on other articles to add them too.

 

Once you clicked on one article, you will see the "insert the tag" button on the top right of the window. Once you're done, simply click on this button in order to add the tag in your Newsletter editor.

 

 

Parameters

 

 

Intro Word Wrapping : If you insert only the introduction, AcyMailing will insert all the text before the "read more" link.
But if you didn't insert the read more link in your Joomla Content, AcyMailing will only load the first XX characters of your content.
If you specify 0, AcyMailing won't wrap your content and load the entire article if you didn't add the "read more" link.

Display articles: This parameter enables you to filter the list of articles in the tag system

All articles: AcyMailing will display all your articles

Only published articles: AcyMailing will only display your published articles

Remove pictures: This parameter enables you to remove the pictures from your article

Never: the pictures won't be removed

 Only for the intro: the pictures will be removed if you include the article intro only

Always: the pictures will be always removed from the inserted article

Remove javascript: This option enables you to remove any javascript code included in your article as the javascript won't work in most of mail clients.

 

 

Plugin: Community Builder

The AcyMailing plugin for Community Builder enables you to add a Mailing list subscription on your Community Builder registration form.

It also enables your users to modify their subscription by editing their profile.

Please make sure the AcyMailing User Plugin ("User - AcyMailing") is turned OFF on the Joomla Plugin Manager.

 

Download the AcyMailing plugin for Community Builder

Click on the download menu at the top of the website http://www.acyba.com.

At the bottom of the download page, you will find the list of plugins which are not automatically installed with the component.

Click on the link in order to download your Community Builder plugin for AcyMailing and save the file on your computer.

 

 

Install the Plugin

Log in to your backend and click on the menu "Components -> Community Builder -> Plugin Management".

At the bottom of the Plugin Management page of Community Builder, you will see an area enabling you to upload a new plugin.

Browse for the AcyMailing plugin you just downloaded and then click on the button "Upload File & Install".

You should now see the AcyMailing Plugin part of the Community Builder Plugins. Don't forget to publish the AcyMailing plugin.

 

Configure the Plugin

 

 Visible Lists : The selected lists will be displayed as visible on your Registration form.
You can easily choose one or several lists using the "select" button which will open a popup and display all your lists.

Hidden Lists : The selected lists will be added on your Registration form but they will be hidden, which means that the user will be automatically subscribed to those lists without knowing it.
Please do not select the same lists for the visible lists and hidden lists since those lists will be hidden.

Lists checked by default : The selected lists will be checked by default.
Some countries do not allow you to check lists by default if it's not for "non-profit". This option will let you easily check some lists and not others in order to stay compliant with your local rules.

Display Receive HTML/Text : If you turn Off this field, the option "receive : Html / Text" won't be displayed and the user will be added with the option "receive HTML" ON.

Description as an overlay : You can add the description of the list in an overlay on the visible lists.
Be careful! If you turn this option On, you might have conflicts with Internet Explorer and flash.

 

 

Plugin : Statistic picture

This plugin enables you to add a picture in your Newsletter which will handle the statistics (who opened your e-mail, when...).

By default the plugin will add in all your e-mails a little blank picture but you can change the parameters to add your own picture instead of the useless blank one.

 

Parameters

 

  Stat picture : Relative path of the statistic picture on your website. By default it will be a small blank picture.
Only PNG format will be accepted.

Stat picture width : Width of the statistic picture. This width should be modified if you change the statistic picture by your own one.

Stat picture height : Height of the statistic picture. This height should be modified if you change the statistic picture by your own one.

 

Change your statistics picture

 

By default a small invisible blank picture will be added at the end of your e-mail.
Nevertheless, for any reason, you might want to change this picture and use your own one.

 

Edit the statistics plugin and change the stat picture (please remember you can only use PNG images).

Set the right width and height of your picture in the plugin

Save the plugin

 

So now, AcyMailing will add your own picture in all html e-mails sent by AcyMailing.

You can send to yourself a test of your Newsletter to make sure this is done properly.

But you might also want to change the place where the picture is displayed in your Newsletter.
For that, you can use the tag {statpicture} in your Newsletter and this tag will be replaced by the statistic picture (instead of being added at the end of the e-mail).

 

For example, on Acyba.com we specified our own picture (Acyba Services) so that when we create a Newsletter, the statistic picture is our own logo.

 

 

In some cases you will also want to remove your statistic picture for an important e-mail (that should reduce your spam score).
If you want to do that on one specific e-mail without having to turn off the stat plugin, simply add the tag {nostatpicture} at the end of your Newsletter.