sc.social.viewcounter

Overview

sc.social.viewcounter provides most accessed / viewed content ranking for Plone sites.

Requirements

• SQLAlchemy 0.5
• z3c.saconfig
• pysqlite (used for testing)
• A database connector

Installation

First step prior to using sc.social.viewcounter is to add a zcml slug to provide a named session 'sc.social.viewcounter.db'. This could be done on the configure.zcml, but you must add the xmlns for db in the configure tag and also include z3c.saconfig into your product

<configure
    ...
    xmlns:db="http://namespaces.zope.org/db"
    ...>

    <include package="z3c.saconfig" file="meta.zcml"/>

    <db:engine name="sc.social.viewcounter.sqlmemory" url="sqlite:///:memory:" echo="True" />
    <db:session name="sc.social.viewcounter.db" engine="sc.social.viewcounter.sqlmemory" />

</configure>

Please refer to z3c.saconfig documentation on how to configure url connection strings for your databases.

To enable this product, on a buildout based installation:

1. Edit your buildout.cfg and add sc.social.viewcounter to the list of eggs to install

   [buildout]
   ...
   eggs =
       ...
       sc.social.viewcounter
   

2. Tell the plone.recipe.zope2instance recipe to install a ZCML slug:

   [instance]
   ...
   zcml =
       ...
       sc.social.viewcounter
   

If another package depends on the sc.social.viewcounter egg or includes its zcml directly you do not need to specify anything in the buildout configuration: buildout will detect this automatically.

After updating the configuration you need to run the ''bin/buildout'', which will take care of updating your system.

Go to the 'Site Setup' page in the Plone interface and click on the 'Add/Remove Products' link.

Choose the product (check its checkbox) and click the 'Install' button.

Uninstall -- This can be done from the same management screen, but only if you installed it from the quick installer.

Note: You may have to empty your browser cache and save your resource registries in order to see the effects of the product installation.

Sponsoring

Development of this product was sponsored by Simples Consultoria customers, including (but not limited to):

• Rede Brasil Atual
• Consumidor Moderno
• Ciência Hoje

Credits

• Erico Andrei (erico at simplesconsultoria dot com dot br) - Packaging and plumbing.
• Luciano Pacheco (pacheco at simplesconsultoria dot com dot br) - Coding bugfixing and much of day to day use.
• Daniel Vainsencher (daniel at simplesconsultoria dot com dot br) - Bugfixing.

1.0.7 (2010-08-18)

• Move pysqlite from install_requires to test_requires. [erico_andrei]

1.0.6 (2010-03-22)

• Reports view now exposes a cache invalidation function [erico_andrei]
• No cache allowed if we get no resultset [erico_andrei]
• Hashing keys now consider a str version of arguments [erico_andrei]
• Improve tests on caching [erico_andrei]
• Disable sqlalchemy query echoing when running tests [erico_andrei]

1.0.5 (2010-03-15)

• Language is considered when creating hashs for memoize[dtremea]

1.0.4 (2010-03-14)

• Handle connection errors [erico_andrei]

1.0.3 (2010-03-13)

• Use of memoize to cache resultsets [erico_andrei]
• Creation of a new index in order to speedup reports [erico_andrei]

1.0.2 (2009-11-17)

• Adding support to filtering reports based on data like existing as indexes on portal_catalog. [erico_andrei]

1.0.1.2 (2009-11-17)

• What about including zcmls? [erico_andrei]

1.0.1.1 (2009-11-14)

• What about including zcmls? [erico_andrei]

1.0.1 (2009-11-12)

1.0.1 (2009-11-12)
-----------------

• Fixes documentation [erico_andrei]

1.0 (2009-11-12)

• Fixes portlet assignment [erico_andrei]
• Ordering is finally working [erico_andrei]
• Filter rankings by workflow [erico_andrei]
• Doctests for base functionality [erico_andrei]
• Fixes bug with cloud_search [lucmult]

0.6 (2009-09-05)

• Updates documentation and prepare release [erico_andrei]
• Fix a bug that occured when viewcounter viewlet was called from a browser view without a proper sqlalchemy session. [erico_andrei]
• Avoid counting page views when user is updating, sharing or using any template (or browser view) not listed in getAvailableLayouts [lucmult]

0.5 (2009-07-04)

• Initial release [erico_andrei]