A Plone tool supporting different levels of subscription and notification.
Project description
Important
This version is intended to the sites that ran under Plone 2.x with a former version of this component and that migrated to Plone 3.x
New sites built with Plone 3.x or later should consider using iw.subscriber instead.
To install subscription portlets use the classical portlet in plone3 portlets dashboard.
template = portlet_subscription (and/or portlet_keywords_subscription) macro = portlet
Dependencies
Plone 3.0.x
DataGridField 1.0
PloneMaintenance 1.1
Make sure to install PloneMaintenance before PloneSubscription
Really recommended, but requirement is not enforced
Can be useful to send out scheduled notifications automatically
Installation
Installing PloneMaintenance
Unpack it into your Zope Products Folder
Restart Zope
Use portal_quickinstaller to install the PloneMaintenance in ZMI (or use plone_setup in pmi)
Setup a scheduler interface as said in PloneMaintenance/README.txt
Installing PloneSubscription
Unpack it into your Zope Products Folder
Restart Zope
Use portal_quickinstaller to install the PloneSubscription in ZMI (or use plone_setup in pmi)
Overview
PloneSubscription: A Plone tool for managing subscriptions
The tool allows members and administrators to manage user and group subscription for content as well as for keyword searches. Content subscription can be done recursively and with the possibility to filter for documents that were recently subject to a workflow transition.
There is a special tool for managing mail templates for subscription mails sent by PloneSubscription. The template system is fairly simple for the moment, but we are looking for improvement proposals to make it more powerful.
Further PloneSubscription information can be found at http://ingeniweb.sourceforge.net/Products/PloneSubscription
Usage
Plone members will find a new icon document action (on the right side under the title), which allows them to quickly subscribe to content. Subscription is done with a single click, and doesn’t disturb the member any further.
Users can check their subscriptions by clicking on “my subscriptions” link, available in the user action box. The link to “my subscriptions” is only shown when a user is already subscribed to something.
Another way of subscribing to content is after doing a search in Plone. In a special portlet, the member can choose to subscribe to the search he just made. This feature is only available for a simple Plone search, and will ignore any advanced search options that may have been chosen.
Subscriptions can also be managed on a per group basis, but as this is an advanced feature it is only available for members who explicitly get the “PlacelessSubscription: Manage Content” permission.
With this permission, an administrative user can add group subscriptions in just three clicks. First click on the “grouped subscription” tab on the current content, select the groups to subscribe, and click on save, and you are done.
The permission also allows access to the PloneSubscription tool in the Plone Control Panel.
Some noteworthy options of the PloneSubscription tool are:
The ‘show actions’ option, which adds extra tabs on folderish objects for quickly adding subsciption and mail template providers locally. This is mostly interesting while doing through the web development.
The ‘periodicity’ defines after which period of time the subscriptions are sent. You can send hourly, daily, weekly and yearly subscriptions.
The ‘Base url’ field is used to replace a url like ‘http://127.0.0.1:8080/plone’ by ‘http://mydomain.com/’ in the link provided in the sent mails.
Mail sent is managed with templates stored in a specific repository. It’s easy to add new variables to the template namespace. The next release of PloneSubscription will focus on a refactoring of these templates so that they are more subscription centric instead of type centric.
Advanced Usage
Your users should not need access the subscription objects themselves, so the “PlacelessSubscription: Manage Content” permission is not given to Members any more.
The best practice is to make sure the subscriptions are already added the right way by passing in the correct parameters as it is done in the portlet:
‘/addSubscription?ptype=’+ptype + ‘&recursive=1&workflow=1&transitions:list=publish&transitions:list=visible’
In this case you need to set the ptype to the subscription type you want and specify the parameters in advance.
Tracing email
Add to your zope.conf
<product-config plonesubscription> trace_send_mail True </product-config>
Changes log
1.6.3 (2011-07-04)
Construct well url in VHM context.
1.6.2 (2011-06-30)
fix bug for workflow transition subscriptions
1.6.1 (2011-06-30)
Add three new button in admin interface for easiest management
1.6.0 (2011-06-29)
add a new option for tracing email sending add to zope.conf
<product-config plonesubscription> trace_send_mail True </product-config>and mail send is trace on event.log
1.5.0 2010/12/1
Create configuration options for subscription portlet, keywords portlet, root site subscription, document action display.
Adding a subscription, then changing a document and sending subscriptions didn’t work. Unfortunately, this is exactly what people will do when testing PloneSubscription the first time:(. It was validated that the last subscription time minus the current time is bigger than the periodicity. This makes sense after the first sending, but not at the moment of the first sending.
Remove on transition filter in subscription portlet
Add afterQueryFilters on subscriber_view results preview
Change subscriber_view columns order: results preview move to last
Fix loosing subscriptions with all virtualhosting solution
i18n refactoring
Manage Subscriptions Permission added to control access to the management template accessible from the portlet_subscription.pt
Fix getGroupSubscriberVocabulary
Folder Subscriptions done from the subscription_portlet now subscribe to the publish transition of content recursively
Adding last modified column to my subscriptions list
Anonymous needs view content permission, not edit
Fix problem with unsubscribing from FolderSubscriptions
Added portlet for subscription by anonymous or member
Add workflow transitions field to FolderSubscription, which makes it possible to notify only for the specified transitions
Store references to root in portal_subscription. As the Plone Site is not an Archetype, there is no other solution for now.
1.2.0 2005/01/24
Fix hit link in subscriber_view
Take exact_search parameter into account in setSubscription
Fix getSubscriptionUrl of ExactSearchSubscription
subscription_management.pt added
Fix getQuery in ContentSubscription. getRecursive was used, but is only available in FolderSubscription
AnonymousUser gets user info and associated getProperty method to match member API
Only send unsubscription mail in removeSubscription if subscription_tool.getAnonymous_unsubscribe_by_email()
Subscription Management now takes content and folder subscriptions into account.
Functional Tests for Anonymous Folder Subscription
getUsers method in AnonymousSubscriber.py now correctly returns a list
Anonymous can subscribe by default now. If you don’t want this, change remove the following permissions for Anonymous:
PlacelessSubscription: Add Content
PlacelessSubscription: View Content
getQueryBrains was not searching in the right catalog (MR 2005/12/28)
fix problem with wrong path index (realPath) in some subscriptions (MR 2005/12/28)
changed parameters to getQueryBrains (MR 2005/12/28)
Fix reference editing in tool. Using ReferenceBrowserWidget now. (MR 2005/12/27)
getUpdatedSubscriptions returns objects, not catalog brains any more (MR 2005/12/27)
Factor out mailing_by_user from mailing (MR 2005/12/27)
Template for previewing mails to be sent out for subscriptions: subscription_mailing.cpt (MR 2005/12/27)
1.1.0 2005/12/13
Fix missing dependencies added with ExactSearchSubscription
Added ExactSearchSubscription for more advanced catalog searches.
EditSubscriptionContent only for Manager by default. Owner doesn’t care.
The portal_catalog does not contain any more PloneSubscription related content. Only ContentSubscription, FolderSubscription and KeywordSubscription are really needed, and are now kept in the portal_subscriptions catalog.
Get rid of SubscriptionCatalogAware
get rid of TOOL_ID and CATALOG_ID
Use getCatalog instead of getSubscriptionCatalog
Use getProvider method directly. Remove getSubscriptionProvider method
subscription_catalog moved from subscription provider to portal root
Factor out the afterQueryWorkflowFilter from afterQueryFilters
Factor out the getQueryBrains method to the subscription_tool
Content Subscription with its own template added (2005/11/19 MR)
Adding a countSubscriptions method
add and remove subscription scripts now controlled python scripts with validator scripts. (2005/11/15 MR)
Allow hiding subscribe and unsubscribe actions
Added a script for exporting subscribers as a csv file
Added macro to plonesubscription_macros for sending a mail to all subscribers (2005/11/14 MR)
Implement removeSubscription, also for anonymous
Make the hiding of the remove button in my subscriptions an option
Remove unused getSubcribersFor
Remove addSubscriber method
Remove unused getSubscriberUrl method
Implement hasSubscription method
Removed listSubscriberByType method, now in getGroupSubscriberVocabulary
Add GroupSubscription didn’t show as the action only showed when there already were GroupSubscriptions.
Removed unused method getMemberSubscriptionUids and listSubscriberTypeSubscriptions
Extended getSubscriptions method to allow search by content and by username. The method doe snot return a tuple anymore, so take care.
implementing useful isSubscribedTo method in subscription tool
Install extra indices, fixing the problem with getRpath index indexing getPhysicalPath instead of getRPath
getSubscriberInfo implemented to get information on the member behind a subscription
Added plonesubscription_macros, containing useful self-subscription and management macros. (2005/11/08 MR)
Added logging facilities with a debug.txt file (2005/11/07 ED)
Fix maintenance job security problem: the script is replaced by an external method (2005/11/07 ED)
Various fixes (2005/11/07 ED)
1.0.1 2005/10/25
Added PloneSelenium Functional Tests (2005/10/24 Maik Rder)
Remove dependency on PloneInstallation 2005/10/23 (Maik Rder)
Move PloneInstaller code into PloneSubscription 2005/10/23 (Maik Rder)
Rewrote Readme, fixed some typos and method security settings 2005/10/20 (Maik Rder)
Made it backward compatible to GroupUserFolder 2.0.1 2005/10/20 (Maik Rder)
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for Products.PloneSubscription-1.6.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | aabf142bea22976cdc65ad97a65a8ff4698dde63882b806f01a2d29d3ce57370 |
|
MD5 | 996eba5a890a3214d1bb454244e21611 |
|
BLAKE2b-256 | 6e1ebfe0360d6ab48d656bb51010bf8759ddf361b86a2162729849a81818c286 |