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
  • Users
  • Videos
  • Groups
  • Discussions
  • Events
  • Photo Albums
  • Photos
  • User Fields
  • Filter
  • Styling
  • Users
  • Videos
  • Groups
  • Discussions
  • Events
  • Photo Albums
  • Photos
  • Parameters
  1. Integration plugins
  2. User management

Plugin: JomSocial

Last updated 4 years ago

Description

​This plugin enables you to include in your Newsletter or any other e-mail JomSocial Information on the user (Group, Username...).

Plugin

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

Go to the JomSocial tab. You will see 8 sub-tabs.

Users

The first tab, Users, allows you to insert users from JomSocial.

  • Max. number of items: Maximum number of users to display

  • Columns: Number of users on a row

  • Order by: The order criterion to use. Once the tag generated, it will appear as [...]|order:,DESC[...]. You can change the DESC keyword to ASC to reverse the order

  • Number of characters (About Me): Number of characters to crop the "About me" field to

Regarding the Thumbnail field (= user avatar), here is a description of the available options

  • Resized: Resizes the image to fit in a box of the specified size (pixels). Keeps the proportions

  • Required: Ensure that only users with a custom avatar are displayed, not those with the default avatar

If you want to change the display order of one of the field (for example, email before karma), just change it in the generated tag.

Thus, |fields:title,karma,email" becomes |fields:title,email,karma

Please note that the "Name" field ("title" in the tag) will always be displayed first, whatever it's position in the tag.

You can choose to not display the first n users by adding |start:n to your tag, with n being an integer greater than 0.

This parameter works for all the tabs (Videos, Groups,...).

To not render the labels, add the parameter |nolabel. It also works with the other tabs.

Finally, you can define your own template by creating a file named "jomsocialusers.php" in "/media/com_acymailing/plugins/".

Most of the data you may want is in $user, $juser, $image, $profileLink and $extraFields variables.

For more information, have a look at _replaceusers() in the plugin's source code.

Videos

The second tab, Videos, enables you to insert videos from JomSocial.

You can restrict displayed videos to some categories only. To achieve that, select one or more categories in the Categories section.

Top parameters are the same as Users tab.

You can define your own template by creating a file named "jomsocialvideos.php" in "/media/com_acymailing/plugins/".

Most of the data you may want is in $video and $image variables.

For more information, have a look at _replacevideos() in the plugin's source code.

Groups

The third tab, Groups, works the same way as the previous tab. The main difference is it inserts groups instead of videos.

You can define your own template by creating a file named "jomsocialgroups.php" in "/media/com_acymailing/plugins/".

Most of the data you may want is in $group and $image variables.

For more information, have a look at _replacegroups() in the plugin's source code.

Discussions

The fourth tab, Discussions, allows you to insert discussions from JomSocial. It is no different than Groups and Videos tabs, except you cannot restrict discussions by categories.

You can define your own template by creating a file named "jomsocialdiscuss.php" in "/media/com_acymailing/plugins/".

Most of the data you may want is in $discuss and $image variables.

For more information, have a look at _replacediscuss() in the plugin's source code.

Events

As you can guess, the fifth tab enables you to insert events from JomSocial.

Two new parameters are available

  • Upcoming Events: When checked, will only display events whose start date is in the future

  • Type: JomSocial events can be of type User (birthday,...) or Group (meeting,...). The checkboxes let you choose the type(s) to display.

You can define your own template by creating a file named "jomsocialevents.php" in "/media/com_acymailing/plugins/".

Most of the data you may want is in $event and $image variables.

For more information, have a look at _replaceevents() in the plugin's source code.

Photo Albums

The sixth tab can be used to display Photo Albums in a similar way than Users, Videos, Discussions, Groups and Events. No new parameter.

You can define your own template by creating a file named "jomsocialalbums.php" in "/media/com_acymailing/plugins/".

Most of the data you may want is in $album and $image variables.

For more information, have a look at _replacealbums() in the plugin's source code.

Photos

Use this tab when you want to display a list of photos from JomSocial.

Unlike the previous tabs, you cannot choose to display any field.

If there is a caption, it will be displayed when hovering the image.

You can define your own template by creating a file named "jomsocialphotos.php" in "/media/com_acymailing/plugins/".

Most of the data you may want is in $link, $onePhoto and $image variables.

For more information, have a look at _replacephotos() in the plugin's source code.

User Fields

This tab enables you to include in your Newsletter or any other e-mail the User's Information from JomSocial.

It will only works if all your visitors are linked to a JomSocial User! If you allow simple visitors to subscribe to your Mailing Lists, you may have subscribers in AcyMailing which are not registered on your website. Indeed, it will be impossible to replace the information in that case (the tag will simply be ignored and replaced with an empty string).

You can resize thumb and avatar fields by setting parameters maxwidth and maxheight in the tag. For example: {jomsocialfield:avatar|maxwidth:87|maxheight:103}

Click on one of the jomSocial user field to directly see the tag inserted in your Newsletter.

You can copy/paste the generated tag in your Text area or even in the Subject of your Newsletter if you want to.

The fields "avatar" and "thumb" will be replaced by the avatar picture or the thumbnail avatar picture of the user.

Filter

You can set a filter on any information of the JomSocial User profile

JomSocial filter

Styling

You can style generated elements by putting this rules in your template's stylesheet

Users

/* Table containing a user */.jomsocialuser {}/* Cell containing the user's avatar */.jomsocialuser .figure {}/* Link associated to the avatar */.jomsocialuser .image {}/* Avatar image */.jomsocialuser .figure img {}/* Cell containing every other user's information */.jomsocialuser .figcaption {}/* User name */.jomsocialuser h2 {}/* Attribute xxxxx * with xxxxx in birdthdate, about, address, website, college, graduation, * karma, avatar, email, registerdate, lastvisitdate, views, friends * + custom fields names */.jomsocialuser .xxxxx {}/* Attribute xxxxx title */.jomsocialuser .xxxxx h3 {}

Videos

/* Table containing a video */.jomsocialvideo {}/* Cell containing the video's screenshot */.jomsocialvideo .figure {}/* Link associated to the screenshot */.jomsocialvideo .image {}/* Video's screenshot */.jomsocialvideo .figure img {}/* Cell containing every other video's information */.jomsocialvideo .figcaption {}/* Video title */.jomsocialvideo h2 {}/* Attribute xxxxx * with xxxxx in description, duration, uploadedby, uploadedon, views, category */.jomsocialvideo .xxxxx {}/* Attribute xxxxx title */.jomsocialvideo .xxxxx h3 {}

Groups

/* Table containing a group */.jomsocialgroup {}/* Cell containing the group's image */.jomsocialgroup .figure {}/* Link associated to the image */.jomsocialgroup .image {}/* Group's image */.jomsocialgroup .figure img {}/* Cell containing every other group's information */.jomsocialgroup .figcaption {}/* Group name */.jomsocialgroup h2 {}/* Attribute xxxxx * with xxxxx in category, created, membercount, discusscount, wallcount, activitiescount, creator */.jomsocialgroup .xxxxx {}/* Attribute xxxxx title */.jomsocialgroup .xxxxx h3 {}

Discussions

/* Table containing a discussion */.jomsocialdiscuss {}/* Cell containing the discussion's image */.jomsocialdiscuss .figure {}/* Link associated to the image */.jomsocialdiscuss .image {}/* Discussion's image */.jomsocialdiscuss .figure img {}/* Cell containing every other discussion's information */.jomsocialdiscuss .figcaption {}/* Title of the discussion */.jomsocialdiscuss h2 {}/* Attribute xxxxx * with xxxxx in content, lastreplied, created, creator, group, replies */.jomsocialdiscuss .xxxxx {}/* Attribute xxxxx title */.jomsocialdiscuss .xxxxx h3 {}

Events

/* Table containing an event */.jomsocialevent {}/* Cell containing the event's image */.jomsocialevent .figure {}/* Link associated to the image */.jomsocialevent .image {}/* Event's image */.jomsocialevent .figure img {}/* Cell containing every other event's information */.jomsocialevent .figcaption {}/* Title of the event */.jomsocialevent h2 {}/* Attribute xxxxx * with xxxxx in description, startdate, enddate, creator, created, * category, ticket, confirmed, maybe, invited, location */.jomsocialevent .xxxxx {}/* Attribute xxxxx title */.jomsocialevent .xxxxx h3 {}

Photo Albums

/* Table containing an album */.jomsocialalbum {}/* Cell containing the album's image */.jomsocialalbum .figure {}/* Link associated to the image */.jomsocialalbum .image {}/* Album's image */.jomsocialalbum .figure img {}/* Cell containing every other album's information */.jomsocialalbum .figcaption {}/* Title of the album */.jomsocialalbum h2 {}/* Attribute xxxxx * with xxxxx in description, creator, created, group, hits, location */.jomsocialalbum .xxxxx {}/* Attribute xxxxx title */.jomsocialalbum .xxxxx h3 {}

Photos

/* Table containing a photo */.jomsocialphoto {}/* Cell containing the photo's thumbnail */.jomsocialphoto .figure {}/* Link associated to the thumbnail */.jomsocialphoto .image {}/* Photo's thumbnail */.jomsocialphoto .figure img {}

Parameters

There is no parameters for this AcyMailing Plugin.