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

Show/Hide css code

View source
 
/* 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

Show/Hide css code

View source
 
/* 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

Show/Hide css code

View source
 
/* 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

Show/Hide css code

View source
 
/* 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

Show/Hide css code

View source
 
/* 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

Show/Hide css code

View source
 
/* 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

Show/Hide css code

View source
 
/* 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.

Follow us :