Insert Joomla articles in your newsletter

Description

The plugin "Joomla content" 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.

You can also use this plugin to include a series of articles based on some filters (the latest 5 created articles for example) in your Newsletter but also in your Smart-Newsletter.

Plugin

When writing a Newsletter, click on the Tags button to access the AcyMailing tag system and being able to include any content in your Newsletter.

Joomla Content

Click on one of your articles 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.

Plugin Content

Display
- Title only will display the title
- Intro Only will display the title + everything before the read more link
- Text will display the title + everything after the read more link
- Full text will display the title + the entire article
Format: Select the way you want to display the article's main data (title, image and text)
Display pictures: You can choose to display or not the pictures and resize them
Clickable title: Should AcyMailing add a link to your article on its title?
Author's name: display or not the author's name
Additional parameters you can manually add in the tag:
- notitle : the tag will be replaced without adding the title Example: {joomlacontent:151|type:intro|notitle} will be replaced by the introduction of the content ID 151 without the title
- noreadmore : this parameter will force AcyMailing to not add any read more link Example: {joomlacontent:151|type:intro|link|noreadmore} will be replaced by the introduction of the content ID 151 but without read more link
- wrap : If you insert the introduction only, AcyMailing will insert your content before the read-more link. Nevertheless if you want to limit it to the first XX characters anyway, you can specify in your tag the parameter "wrap" with the number of characters you want AcyMailing to insert. Example {joomlacontent:151|type:intro|wrap:200}
- readmore : This parameter enables you to force AcyMailing to use another "read more" text instead of the default one. This parameter can be very useful if you have a multi-lingual website so you can make sure the read more link will be translated in the right language. Example: {joomlacontent:151|type:intro|readmore:Click here to read the full story!}
- created : If you add this parameter to your tag, then the article created date will be displayed. Example: {joomlacontent:151|type:intro|created}
- modified : If you add this parameter to your tag, then the article modified date will be displayed. Example: {joomlacontent:151|type:intro|modified}
- dateformat : If you add the "created" parameter, you can use the "dateformat" parameter to specify the date format you want to use. Example {joomlacontent:151|type:intro|created|dateformat:%m %Y}
- itemid : AcyMailing will automatically attach your read more link to a menu ID. You can nevertheless force AcyMailing to use the one you want if you specify one via the parameter itemid. Example: {joomlacontent:151|type:intro|itemid:22}
- autologin : If you add this parameter, AcyMailing will add the username and encrypted password to the article link so if the user clicks on it, he will be automatically logged if you installed the AutoLogin plugin for Joomla.
- jtags : If you add this hidden parameter, AcyMailing will display the article's tags if any (feature only available for Joomla 3.1.0+)
- nomainimage : If added to a tag, AcyMailing won't display the main picture of the inserted articles Example: {joomlacontent:151| type:intro| nomainimage}

Parameters

content plugin

Plugin Content Params

Custom template : Click on this button if you want to create a custom template for the plugin's output (you'll find an example at the end of this documentation)
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
Front-end Access : Using AcyMailing Enterprise, you can restrict the access to this tag system on the front-end
- Display all articles : all articles will be displayed on the front-end edition (default option)
- Display only author's articles : only author's articles will be displayed on the front-end edition
- Don't display this tag system on the front-end : this plugin won't be displayed on the front-end edition
Select articles by meta tags : AcyMailing is able to filter your content based on the keywords. If you turn ON this option, you will see an additional filter on our tag system so your articles can be filtered by meta tags. Meta tags must be separated by a comma.
Act for another component : By default, article links will be redirected to the Joomla content but you can choose AcyMailing uses other links used by other components.
Display : The default value for the "Display" option in the tag popup
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.
Clickable title : Default value for this option in the tag popup
Author name : Default value for this option in the tag popup
Display pictures : Default value for this option in the tag popup
Max picture width : If you select the resized option in your tag, AcyMailing will resize your pictures. You can specify the default maximum width displayed in the plugin.
Max picture height : If you select the resized option in your tag, AcyMailing will resize your pictures. You can specify the default maximum height displayed in the plugin.

Customize your article template

Customize your article using some CSS

You can change the styles used for the content title and the content area by editing your AcyMailing template.

Edit the AcyMailing template used for your Newsletter and then set some styles:

Style for the article area will be used to encompass your article
Style for the article title will be applied to your content title
Style for the read more link will be applied to your read more link (if you have one)
You can also set the style of all your links using the Style of the links field

Set styles template

So you can easily customize the look of your article and get something like:

Create your own template

You can also modify the way your article is displayed by creating your own template which will be used to render the article. Please follow those instructions, we don't recommend you to modify the tagcontent plugin directly otherwise your changes will be overwritten when you update AcyMailing.

Click on the "Custom template" button in the plugin's configuration page to create a new template, then enter the layout you want in the appearing popup. If you created a custom template, you will be able to select it with the "Format" option the next time you'll insert an article tag.

In this custom template, you can use PHP to access the element $article (which is the article object loaded from the content table) and the element $tag (which contains the information of the current tag used in your Newsletter). You can also access the article's content using this simple syntax: {title}, {introtext}, {link}, ... You can see what data you can access in the variable $varFields:

<?php
foreach($varFields as $key => $value){    
    echo '{ '.trim($key, '{}').' } => '.$value.'<br/>';
}
?>

You can display:

the title of your article: {title}
the intro of your article: {introtext}
the full content of your article: {fulltext}
the url of your article: {link}
the image of your article: {picthtml}
the formatted creation date: {createddate}
the formatted modification date: {modifieddate}

Using all those variables, you can create your own content template.

By default AcyMailing uses something like this:

<div class="acymailing_content">
    <a href="{link}" name="content-{id}" target="_blank" >
        <h2 class="acymailing_title">{title}</h2>
    </a>
    {picthtml}{introtext}<br/>
    {fulltext}
</div>

Last updated 4 years ago

Insert Joomla articles in your newsletter

Description