Ary/NotificationAry

Action

You are not authorized to view this content

Author

Created

Emails:

Notification rules group

Add extra email addresses (1 per line) to be notified

Add extra email addresses

Always

Enter the content item IDs to notify or not when updated. Use commas to separate IDs. If you changed content type, make sure the IDs belong to the content type. E.g. you used content type Articles before and selected some article ids. Next you switched to content type K2. In this case you have to remove previous IDs and enter new ones.<br/><b>Please note!</b>If the '#~#JSELECT#~#' to the right is present, but works incorrectly, then enter IDs manually

Content item IDs

Attach diff info

Notify in categories

You may want to attach the previous version of the item. This may be useful if you'll want to restore the content later.

Attach previous version?

Most mail clients have limited HTML support. Besided your content may be styled with your template CSS. So the HTML format may look bad. Use plain text format if you want to be sure that the mail is readable.

Email format 

Enter email addresses (1 per line) to exclude

Exclude Selection

Exclude Users

For all users` changes?

For every modifier

General settings

Generate fake users?

Include title

Include author name

Include backend edit link

Include category

Include created date

Include diff info

Include frontend edit link

Include fulltext into mail body 

Include fulltext

Include introtext into mail body

Include introtext

Include link to the content item

Include link to view a content item at the Website if published

Include modified date

Include modifier name

Mail could not be sent!

Notification mail has been sent!

Custom

Hardcoded

Available body placeholders:

Placeholders marked with % are plugin prepared complex placeholders. You can also use content object and user fields marked with #. User object is the object of the modifier of the content, while Content object is the content item itself.

Message body to be used

If use hardcoded, then some options can be ignored for non-Article content type. I.e. most other extension don't have introtext field. Use of hardcoded mailbody mostly makes sence for Joomla articles. But you can give it a try with other content types

Message body structure

Message body

HTML body only:

%ACTION% : %SITELINK% : %CONTENT_TYPE% "%TITLE%", editor %MODIFIER%

Available subject placeholders:

Message to be shown in browser after adding or updating a content item

Message to be shown in browser if error occurs

Never

New and Updated

New Only

No specific rules

Notification message settings

Notification rules

Notification switch default value

Notify the author of the content item

Notify author only if one's content item is modified by a user allowed in `#~#PLG_SYSTEM_NOTIFICATIONARY_FIELD_WHERE_TO_SHOW_NOTIFICATION_SWITCH#~#` 
You may need to let the content author know about changes in his content performed by Editors, but not to let the author know about changes perfomed by Super Admins.

Whom to notify

Notify modifier

Notify on action

You may set to notify or not on changes made by users from the selected user group(s)

Whose action to notify? Notify only if content is updated by selected user groups or users

Select whether to assign to a selection or all.<br /><br /><strong>Selection</strong><br />Notify only on selection.<br /><br /><strong>Exclude Selection</strong><br />Notify except on selection.<br /><br /><strong>All</strong><br />Do not limit assignment to a selection.

Notification

You may select whether to send notifications to users, which have no permission to view the content item. For example, you sell access to content and want to inform all users about a new content item. Or you don't want the users who have no permissions to know about a new content item

Notify only if can view

On changes in published only

On changes in unpublished only

On publish only

On publish or unpublish

On unpublish only

Only for allowed modifiers

Selection

Show Error Message?

When editing an content item a switch wether to notify is shown in the edit form.

When editing a content item in frontend site part, a switch wether to notify is shown in the edit form.

Show notification switch in frontend?

Show notification switch when editing content items?

Show Success Message?

Notify in specific content items

You can force to exclude or include specific ID's

Specific Users

Success message

Updated Only

Select User Group Levels to notify

User Group Levels

Select User IDs to notify or not to notify. Separate by comma.

User IDs

If you are logged in to Backend, use this link to edit the content item

If you are logged in to Frontend, use this link to edit the content item

Modified

Modifier

No difference between content items contents found

You can set not to notify users on changes in the content item. For example, you make minor changes and don't want users to be spammed.<br /><b>NOTE:</b>If the notification should not be sent to a user or a group according to the NotificationAry plugin setting, this option doesn't allow it to sent. It can only turn off notifications for those who should receive it.

Notify?

View content item

View link

Users notified: 

Show number of sent emails

Only shown to those, who can login backend

Notify on status

Purpose example: You may want never to notify when content items are in Trashed or Archived status.  <br/>This option allows to notify on the final content item status, while the next option handles status change.<br/>This option has higher priority then the next one. This means if you here allow only published content items, then it will not notify on changes in unpublished content items or on unpulishing A content item disregarding the next option.<br/>So be careful to have proper conjunction of this and the next option.

Try setting script execution time to zero <br/><code>set_time_limit(0);</code>

Show internal info when saving a content item?

If you want the plugin to fire on a third-part extension you must enter the context used when saving a content item and may need to enter a JTable (Item table) class. To get this information enable this option save a content item (e.g. A content item). After done, disable the option. If you don't see a context message, then the plugin cannot handle that extension.

Select content type source to get notifications. 

 
Here you have 2 options. 
<ol> 
<li> You can select a registred to joomla component. This can be a core component, like Joomla articles com_content, but can also be a third-party, which fits Joomla compatibility conventions well enough, like DP Calendar. This will definitely work for Joomla core Articles and most of all will work for other extensions from the list. </li> 
<li>This option may be what you need in several cases: 
<ul> 
<li>You selected a joomla registred component under the first option, but it didn't work well. The plugin is not fired at all, gives a table error or sends worng links to content items</li> 
<li>You want the plugin to work with a component not listed under the first option, for example K2 or HotSpots</li> 
</ul> 
</li> 
</ol> 

Content type

It's a must to save plugin settings if you change the two options above before changing anything else. You must save to reload categories and/or some other dependant fields.

Select a content type to send notification

Define manually

Category ids

Enter category id's manuall separated with comma

Enter category field name in the category object

Need to limit notifications by category id's

Where to run notifications: Extension and content type, categories or certain content items

Content item options to run notifications: action, state, can view etc.

Fire onContentChangeState

Joomla system event onContentChangeState is fired when you change an item state (e.g. publish or unpublish) from an items list view (e.g. articles list).<br/>May not work for some extensions even if enabled

Automatic

Custom

Where and whom to show notification switch to?

Comma separated category IDs

No content

Image path

Absoulte

Relative

Images in HTML mostly have relative path. This is great for Joomla, but when you receive a notfication you cannot view such images. Use absolute path to have images viewable in your emails. This doesn't affect DIFF or any attachments, it only affects inline message images

Frontend link not available for this type of content

Content type

Include content type

A content item has been changed

A content item has been published

A content item has been unpublished

has added a content item  with you set as author

has modified your content item

has published your content item

has unpublished your content item

A new content item

You have just added a content item

You have just added a content item with author %s

You have just published a content item

You have just unpublished a content item

You have just updated a content item

Your content item has been modified

Your content item has been published

Your content item has been unpublished

Your content item ID for further reference is

This content item must be reviewed and may be published by an administrator

Sending notifications

Close this window to cancel

Time to start

Ajax

Be verbose

Enable ajax when sending notifications. Can be useful, when you have a huge number of notification to be sent and meet timeouts or limit exceeds.

Allow to cancel

Allow to cancel notification sending process by closing the ajax window. The process can be cancelled anyway if closing the browser tab.

Delay in sec before sending start

If you want to be able to cancel notification sending process, then you can give a user time to cancel before the sending starts.

Who is allowed to cancel notification sending process? You may wish to allow superadmins to cancel the process, but not to Registred users

System - NotificationAry

<img src='../plugins/system/notificationary/images/logo.png' align='left' style='margin:  0; padding: 0; ' /> 
 
<p>NotificationAry sends a mail to entered recipients, when someone adds/modifies Joomla articles!</p><div class='alert alert-message'>If you feel that something works wrong or illogical, please contact and describe the problem to let it be fixed. The plugin has a great number of conditional statements which are often combined and become very complicated. It's very hard to test all possible combinations after any code update.</div>

Add menu item to Components menu

For quick plugin settings access you may wish to add a menu item to backend component menu

NotificationAry

Use this option only if the plugin generates wrong links to view or edit content items. <br/>Please, copy a link you click to edit or view a content item and paste it here replacing the item id number with the ##ID## placeholder.<br/>Example:<br/>Let's add a K2 backend edit link. Go to the list of K2 items, mouse over an item and copy the link.<br/ >You'll get something like <b>http://testiste.com/administrator/index.php?option=com_k2&view=item&cid=9</b><br/>Remove this part <b>http://testiste.com/administrator/</b> and update the id number. So the posted link should look like <br><b>index.php?option=com_k2&view=item&cid=##ID##</b>.<br><b>NOTE!</b> For frontend edit link you need to turn off SEF temporaty to get the real URL, not aSEF link. Please, also remove Itemid part from the frontend link

Custom extension

<a class='showhidehelperinfo'>Click to show/hide help info how to fill in the template</a><div class='custom_context_help_info hide alert alert-info'> 
First of all you need to determine if the component you want to send notifications for uses Joomla plugin events. 
You may try a predefined template to get the idea what information is needed. To get the needed information: 
<ol> 
<li>Go to the general tab in the plugin settings and temporary enable internal information output( option at the bottom). Save the plugin. 
<br /> 
<a href='http://view.xscreenshot.com/47f6a11d8a7dceb5af141afe99684ba6' class='modal' rel='{size: {x: 800, y: 500}, handler:"_QQ_"iframe"_QQ_"}' ><img style='width:300px' src='http://static.xscreenshot.com/2016/04/10/20/screen_47f6a11d8a7dceb5af141afe99684ba6'></a> 
 
 
</li> 
<li>Save the item you want to send notification on. For example a K2 item or a HotSpot marker.</li> 
<li>Check the Joomla system message you get. 
<br/> 
<a href='http://view.xscreenshot.com/61746f9a549caaf91e3e5ed600163520' class='modal' rel='{size: {x: 800, y: 500}, handler:"_QQ_"iframe"_QQ_"}' ><img style='width:300px' src='http://static.xscreenshot.com/2016/04/10/20/screen_61746f9a549caaf91e3e5ed600163520'></a> 
<ul> 
<li> 
If you get no extended information there, then the system event <b>onContentAfterSave</b> is not fired by the component when saving an item. You may try to ask the component developers to add joomla event hooks, maybe they would like their extension to be compatible with regular joomla plugins. 
</li> 
<li> 
If you get the extended information, then continue. 
</li> 
</ul> 
</li> 
<li> 
Copy the <b>Сontext</b> and the <b>Item table class</b> to the textarea. 
<br/> 
<a href='http://view.xscreenshot.com/61746f9a549caaf91e3e5ed600163520' class='modal' rel='{size: {x: 800, y: 500}, handler:"_QQ_"iframe"_QQ_"}' ><img style='width:300px' src='http://static.xscreenshot.com/2016/04/10/20/screen_61746f9a549caaf91e3e5ed600163520'></a> 
 
 
</li> 
<li> 
Temporary disable SEF in Joomla global configuration to get non-SEF links. 
<br/> 
<a href='http://view.xscreenshot.com/a06f4d6bb0d90431fb762a1ebf389f4a' class='modal' rel='{size: {x: 800, y: 500}, handler:"_QQ_"iframe"_QQ_"}' ><img style='width:300px' src='http://static.xscreenshot.com/2016/04/10/20/screen_a06f4d6bb0d90431fb762a1ebf389f4a'></a> 
</li> 
<li> 
Frontent view link: View a content item in Frontend and copy-paste the link to the textarea. 
<br/> 
<a href='http://view.xscreenshot.com/f0e11db5ee90f8f1f5e53b24d9085637' class='modal' rel='{size: {x: 800, y: 500}, handler:"_QQ_"iframe"_QQ_"}' ><img style='width:300px' src='http://static.xscreenshot.com/2016/04/10/20/screen_f0e11db5ee90f8f1f5e53b24d9085637'></a> 
 
</li> 
<li> 
Frontend edit link: Login as a superadmin to frontend and copy-paste the link you click to edit an item. <br><b>Note!</b> Some components don't have a frontend edit option. In this case enter word <i>false</i> 
<br/> 
<a href='http://view.xscreenshot.com/7ef88fddfd80136f73c25fe404ca7c15' class='modal' rel='{size: {x: 800, y: 500}, handler:"_QQ_"iframe"_QQ_"}' ><img style='width:300px' src='http://static.xscreenshot.com/2016/04/10/20/screen_7ef88fddfd80136f73c25fe404ca7c15'></a> 
 
 
</li> 
<li> 
Enable SEF back. 
<br/> 
<a href='http://view.xscreenshot.com/c20fe1062bf0d7aa62fb7a430a1a949f' class='modal' rel='{size: {x: 800, y: 500}, handler:"_QQ_"iframe"_QQ_"}' ><img style='width:300px' src='http://static.xscreenshot.com/2016/04/10/20/screen_c20fe1062bf0d7aa62fb7a430a1a949f'></a> 
</li> 
<li> 
Backend edit link: Go to the list of items, for example,list of K2 items,  mouse over an item and copy-paste the link to the textarea. 
<br /> 
<a href='http://view.xscreenshot.com/5d29359f2a800774e00ed0ac828d6cfc' class='modal' rel='{size: {x: 800, y: 500}, handler:"_QQ_"iframe"_QQ_"}' ><img style='width:300px' src='http://static.xscreenshot.com/2016/04/10/20/screen_5d29359f2a800774e00ed0ac828d6cfc'></a> 
 
 
</li> 
<li> 
<i>Category table class</i> and <i>Category context</i> rows are optional and help to determine the content item category path. The plugin tries to determine it automatically. <br/>If you badly need the category path in your notification email and it doesn't work with the empty lines, then try to determine options by saving a category and getting the plugin helper system message.<br/> 
For example for K2 this approach  wouldn't work, as K2 doesn't run onContentAfterSave event when saving a category. But this may work for another extensions.<br/> 
If you still cannot determine it, then you must have a look into the component code. 
<br/> 
<a href='http://view.xscreenshot.com/0f3026c36a587b2dd69465fdd2f9b0e0' class='modal' rel='{size: {x: 800, y: 500}, handler:"_QQ_"iframe"_QQ_"}' ><img width='300' src='http://static.xscreenshot.com/2016/04/10/22/screen_0f3026c36a587b2dd69465fdd2f9b0e0'></a> 
 
 
</li> 
<li> 
Now remove parts preceding <b>index.php?...</b>(if not done automatically) in the links and replace the content ID number with the <b>##ID##</b> code. 
</li> 
<li> 
Rows beginning <b>onContent...</b> in most cases should not be touches, as only developers can understand what this means. This lines are used to set alias functions to the core joomla event functions. For example, HotSpots doesn't run joomla core onContentAfterSave at Frontend, but uses an own event which does the same named onAfterHotspotSave. 
</li> 
<li> 
For frontend links you can either remove or leave <b>Itemid=..</b> part. Removing it will force the plugin to try to find a proper Itemid (active menu item) when  updating a content item. Leaving it will force the plugin to use the Itemid anyway. 
</li> 
 
<li> 
Don't forget hide internal information 
<br/><a href='http://view.xscreenshot.com/47f6a11d8a7dceb5af141afe99684ba6' class='modal' rel='{size: {x: 800, y: 500}, handler:"_QQ_"iframe"_QQ_"}' ><img style='width:300px' src='http://static.xscreenshot.com/2016/04/10/20/screen_47f6a11d8a7dceb5af141afe99684ba6'></a> 
</li> 
</ol> 
 
</div>