Plugin: Joomla Content

• Description
• Plugin
  • Joomla Content
  • Categories
• Parameters
• Customize your article template
  • Using some CSS
  • Create your own template

Description

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.

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 auto-Newsletter

Plugin

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

Joomla Content

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.

• 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

• Additional parameters:
  • 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 an other "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}
  • 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}

Categories

You can include in your Newsletter several articles at the same time.
This option can be used for a Newsletter but also for an Auto-Newsletter: select the sections/categories you want to include, then enter a minimum Number of Articles (when the Newsletter should be generated, if there is not enough articles based on the configuration you enter, the Newsletter won't be sent and it will wait until the next generated date) and click on the button Insert the tag.

• Additional parameters:
  • start : this parameter enables you to start the selection of articles after the first one.
    That way you can define different styles for your content.
    Example: {autocontent:cat27|max:5|order:ordering,ASC|type:intro} will display the first 5 articles from the category 27
    {autocontent:cat27|max:8|start:5|order:ordering,ASC|type:intro} will display 8 articles from the category 27 but skip the first 5 articles.
  • featured : this parameter enables you to select featured articles (the articles selected to be displayed on the front-end)
    Using this additional argument, you can create a tag to add all your articles displayed on the front-page:
    Example: {autocontent:sec0|max:10|order:created,DESC|type:intro|featured} will display the intro of the first 10 articles displayed on your front-page.

Examples for an auto-Newsletter

• If you want your automatic Newsletter to include the introduction text of all newly created articles since the last generated Newsletter :
  • Select the sections/categories you want to include
  • Select display : Intro Only
  • Enter a Minimum Number of Articles so that if there is no new article, the Newsletter won't be generated
  • Select the filter : "Only Newly Created"
    
    
    
• If you want your automatic Newsletter to always include the 5 latest created articles :
  • Select the sections/categories you want to include
  • Select the display mode
  • Enter a Minimum Number of Articles : 0 (so that the Newsletter will always be generated)
  • Enter a Maximum Number of Articles : 5 (so that AcyMailing will include up to 5 articles in the generated Newsletter)
  • Select the filter : "All"
    
    
    
• You can use AcyMailing as a notification system for new content so maximum 1 hour after your article is published on your website, your subscribers will receive a notification :
  • Select the sections/categories you want to include
  • Select the display mode
  • Enter a Minimum Number of Articles : 1 (so that if there is no new article, the Newsletter won't be generated)
  • Select the filter : "Only Newly Created"
  • Configure your auto-Newsletter with the frequency "every 1 hour"

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 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.
• Content Access : If you use the automatic article insertion (via the categories tab), AcyMailing will only include articles having the selected access in your Newsletter.
  • Public only : only articles with public access will be inserted in your Newsletter
  • Public and Registered : only articles with public or registered access will be inserted in your Newsletter (default option)
  • All : AcyMailing won't check the articles access rights and so can include articles with "special" access in your Newsletter
• 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
• Max picture height : If you select the resized option in your tag, AcyMailing will resize your pictures. You can specify here its maximum height.
• Max picture width : If you select the resized option in your tag, AcyMailing will resize your pictures. You can specify here its maximum width.
• 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.

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 content area will be used to encompass your article
• Style for the content 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 Link a field

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.

Create a file in the the folder media / com_acymailing / plugins (if the folder does not exists, please create it first).
(Before AcyMailing 1.7.0, the file was located in components / com_acymailing / templates / plugins)
The name of the file should be tagcontent.php
If this file is available on your server, AcyMailing will use it and won't use the default one.

On this file you can access to 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 display:

• the title of your article: $article->title
• the intro of your article: $article->introtext
• the full content of your article: $article->fulltext
• the url of your article: $link

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

By default AcyMailing uses:

Show / hide php code

<div class="acymailing_content">
<a href="<?php echo $link; ?>" name="content-<?php echo $article->id; ?>" target="_blank" >
<h2 class="acymailing_title"><?php echo $article->title; ?></h2>
</a>
<?php echo $article->introtext; ?>
<br/>
<?php echo $article->fulltext; ?>
</div>