AcyMailing
Back to LATEST versionOur siteForumBlog
Version 5
Version 5
  • AcyMailing 5 documentation
  • Main pages
    • Users
      • Export Users
      • Import Users in AcyMailing
      • Mass actions
    • Lists
      • Distribution lists
      • List: Add/Edit
    • Newsletters
      • A/B Testing
      • Spam Test
      • Schedule your Newsletter
      • Smart-Newsletters
      • Campaigns
      • Joomla notifications
      • Simple Sending
      • Templates
        • Import a template
    • Queue
    • Statistics
      • Click statistics
      • Comparison page
      • Statistics charts
    • Configuration
      • Configuration tabs
        • Configure your send process
          • DKIM : DomainKeys Identified Mail
          • External SMTP service
        • Cron task
        • Geolocation
        • Captcha
        • Google Analytics
        • Forward to a friend
        • Access level
      • Custom fields
      • Bounce Handling
      • Unsubscribe page
  • Public part of your site
    • Configure your Subscription Module
    • Latest Newsletters module
    • Newsletter archive section
    • Front-end Newsletter edition
  • FAQ
    • Insert your subscription form in your article
    • Update AcyMailing 5
    • Your send process is slow?
    • Could not instantiate mail function
    • Sending issue
    • Spam issue
    • Compatibility issues
    • Install / Update issues
  • Integration plugins
    • Installed with AcyMailing
      • Insert Joomla articles in your newsletter
      • Plugin : Statistics
      • Plugin: (auto)Subscribe during Joomla registration
      • Plugin: Call to action
      • Plugin: Date - Time
      • GMail Inbox Actions
      • Plugin: Joomla Module Loader
      • Plugin: Joomla User
      • Plugin: Manage Subscription
      • Share your Newsletter on social networks
      • Plugin: Subscriber
      • Plugin: Website Links
      • AcyMailing plugin : table of contents generator
    • User management
      • Plugin: AltaUserPoints
      • Plugin : VirtueMart Checkout Subscription
      • Plugin: CB User
      • Plugin: CJBlog
      • Plugin: com_contact
      • Plugin: Community Builder
      • Plugin: Easy Profile
      • Plugin: EasySocial
      • Plugin: ExtendedReg Profile Information
      • Plugin: Grumpy Contacts
      • Plugin: Ja Job Board
      • Plugin: JomSocial
      • Plugin: JUGA
      • Plugin: K2 Users
      • Plugin: MightyMembership
      • AlphaUserPoints plugin
    • Content management
      • Plugin : AdsManager
      • Plugin: AdsManager (by Heigho)
      • Plugin : Dj-Catalog 2
      • Plugin : Kunena
      • Plugin: AdAgency
      • Plugin: CiviCRM
      • Plugin: Cobalt
      • plugin: Dj-Classifieds
      • plugin: EasyBlog
      • plugin: EasyDiscuss
      • Plugin: Emerald
      • Plugin: EZautos
      • plugin: FLEXIcontent
      • Plugin: Form2Content
      • Plugin: GMapFP
      • plugin: JoomBlog
      • plugin: Joomla! Estate Agency (JEA)
      • plugin: K2 items
      • Plugin: ListBingo
      • plugin: Lyften Bloggie
      • Plugin: MightyResources
      • Plugin: MosetsTree
      • Plugin: Newsfeeds
      • plugin: SEBLOD 3
      • Plugin: Sobi2
      • Plugin: SobiPro
    • Events
      • plugin: !Cagenda
      • Plugin: DPCalendar
      • Plugin: EventList
      • plugin: Event Booking
      • Plugin: jCalPro Events
      • Plugin: jEvents
      • Plugin: Matukio
      • plugin: MijoEvents
      • Plugin: Ohanah
      • Plugin: redEvent
      • Plugin: RsEvents
      • plugin: RSEvents Pro
    • E-commerce
      • Plugin: Awo Affiliate
      • Plugin: HikaShop
      • plugin: JoomShopping
      • plugin: K2Store
      • Plugin: redSHOP
      • Plugin: MijoShop
      • Plugin: VirtueMart Coupons
      • Plugin: VirtueMart
      • AwoCoupon plugin
    • Subscription system
      • Plugin: AEC
      • Plugin : CBSubs
      • Plugin: Membership Pro
      • Plugin: MightyRegistration
      • Plugin: OSE Membership Control Manager
      • Plugin: Payplans
      • Plugin: AkeebaSubs
      • AEC AcyMailing micro-integration
    • Files management
      • Plugin : RokDownloads
      • Plugin: DOCman
      • plugin: DOCman 2
      • Plugin: Document Media Manager
      • Plugin: jDownloads
      • Plugin: Joomdoc
      • Plugin: PhocaDownload
      • Plugin: Remository
    • Other
      • Module: Statistics dashboard
      • module: Quick icon for J1.5
      • Plugin : Module Article
      • plugin: AcyMailing toolbox
      • plugin: Auto-create a list on user registration
      • plugin: Add CC
      • Plugin: Create Joomla user
      • Plugin: Autotweet NG
      • plugin: Edit notification
      • plugin: Export users in mass action
      • plugin: List owner notification
      • Plugin: Modify user group
      • plugin: Quick icon for J2.5 and J3.X
      • plugin: Search
      • Plugin: Smart Search
      • Plugin: Squeeze Page
      • plugin: Stop Smart-Newsletter during weekend
      • Universal tag plugin
      • Universal filter plugin
      • Birthday Newsletter
  • Developers
    • AcyMailing 5 Developer Documentation
    • Customize the way the content inserted in emails by plugins
    • Conditional display
    • Multiple queue system
    • External subscription form
    • Subscription via URL
      • Fabrik Form and AcyMailing
      • ChronoForm and AcyMailing
      • RSForm!Pro and AcyMailing
      • BreezingForms and AcyMailing
Powered by GitBook
On this page
  • Description
  • Plugin
  • Single Item
  • Categories
  • Parameters
  • Customize your Sobi2 item template
  • Customize your item using some CSS
  • Create your own template
  1. Integration plugins
  2. Content management

Plugin: Sobi2

Last updated 4 years ago

Description

This plugin enables you to insert items (one by one or by a selection on one or several categories) from Sobi2 in your Newsletter.

You can also use this plugin to automatically include your newly created (or modified) Sobi2 items in an Auto-newsletter or a Newsletter.

You can search in all your Sobi2 items and then click on one of the item to include it in your Newsletter.

You can download the Sobi2 plugin on our then install and publish it like a standard Joomla plugin.

Plugin

Single Item

Sobi2 Elements

You can use this interface to insert any Sobi2 item in your Newsletter.

Each item can be selected one by one.

  • Display:

    • Title Only: only the title will be inserted

    • Category View: the element will be inserted using the Sobi2 category view

    • Details View: the element will be inserted using the Sobi2 details view

  • Display pictures: You can decide to display or not this picture in your Newsletter or display a resized size of it.

  • Clickable Title: make your title clickable (so linked to your online version) or not.

Categories

Sobi2 Categories

You can select one or several Sobi2 categories and AcyMailing will automatically include the Sobi2 items belonging to the selected categories.

  • Maximum Number of Articles: The inserted tag will be replaced by a maximum of X Sobi2 items.

  • Minimum Number of Articles: This option will only be displayed if you access this plugin for a Smart-Newsletter. AcyMailing will only generate your Smart-Newsletter if the minimum number of Sobi2 items found is reached.

  • Filter: This option will only be displayed if you access this plugin for a Smart-Newsletter. You can set a rule so that only newly created or modified Sobi2 items are added to your Newsletter.

Parameters

Sobi Params

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

    • All articles: AcyMailing will display all your Sobi2 items

    • Only published articles: AcyMailing will only display your published Sobi2 items

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

  • Max picture height / Max picture width : In case of you selected the resized option, AcyMailing will resize your pictures following the specified max height / width.

Customize your Sobi2 item template

Customize your item using some CSS

You can change the styles used for the 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 Sobi item

  • 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

Set styles template

Example:

Example

Create your own template

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

Create a file in the folder media / com_acymailing / plugins (if the folder does not exists, please create it first). The name of the file should be sobi2.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 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)

By default the file should contain:

<?php
$result = ''; $styleTitle = ''; $styleTitleEnd = ''; if($tag->type != "title"){ $styleTitle = '<h2 class="acymailing_title">'; $styleTitleEnd = '</h2>'; }
 if(empty($tag->notitle)){ if(!empty($tag->link)){ $result .= '<a href="'.$link.'" '; if($tag->type != "title") $result .= 'style="text-decoration:none" name="sobi2content-'.$article->itemid.'" '; $result .= 'target="_blank" >'.$styleTitle.$article->title.$styleTitleEnd.'</a>'; }else{ $result .= $styleTitle.$article->title.$styleTitleEnd; } }
 //We add the intro text if($tag->type != "title"){ if($tag->type == "intro"){
 if(!empty($tag->pict) AND (!empty($article->icon) OR !empty($article->image))){ $imagePath = ACYMAILING_LIVE.'images/com_sobi2/clients/'.(empty($article->icon) ? $article->image : $article->icon); $result .= '<img src="'.$imagePath.'" style="float:right;margin:5px" />'; } $result .= $this->_displayFields($extraValues,$this->fieldsintro); }else{ //detail view
 if(!empty($tag->pict) AND (!empty($article->icon) OR !empty($article->image))){ $imagePath = ACYMAILING_LIVE.'images/com_sobi2/clients/'.(empty($article->image) ? $article->icon : $article->image); $result .= '<img src="'.$imagePath.'" style="float:right;margin:5px" />'; } $result .= $this->_displayFields($extraValues,$this->fieldsfull); }
 $result = '<div class="acymailing_content">'.$result.'</div>'; }
echo $result;
plugin section