Package: iw.sitestat
ByIngeniweb.iw.sitestatmakes the glue between a Plone site and a Sitestat
professional analytics service. The Sitestat product is a commercial
application fromNedstat.We assume at that point that your Sitestat service is correctly
installed and configured.Note that the authors ofiw.sitestathave no connection with the
Nedstat company.Requirementsiw.sitestatrequires Plone 3.1 or newer.simplejsonis added automatically by easy_install/zc.buildout.Copyright and licenseCopyright (c) 2008IngeniwebSASThis software is subject to the provisions of the GNU General Public
License, Version 2.0 (GPL).  A copy of the GPL should accompany this
distribution.  THIS SOFTWARE IS PROVIDED “AS IS” AND ANY AND ALL
EXPRESS OR IMPLIED WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST
INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSESee thedocs/LICENSEfile that comes with this component.InstallationWe assume that you created your Zope instance withpaster create -t
plone3_buildout <your-instance>or something similar. And of course
you’re supposed to know how to set up a Plone site using zc.buildout.With zc.buildoutRecommended practice for integration or production instances.Openbuildout.cfgwith your favorite text editor and change it like
indicated below:[instance]
...
eggs =
  ...
  iw.sitestat
  ...
zcml =
  ...
  iw.sitestatRun your buildout, you’re done.From Subversion repositoryRecommended practice for developers.Install as indicated inWith zc.buildoutabove.Checkout your preferred trunk/branch ofiw.sitestatin $BUILDOUT/src
(You should have $BUILDOUT/src/iw.sitestat/… after this). See theProject home pagessection for the repository URL.Then:$ cd $BUILDOUT/src/iw.sitestat
$ python setup.py developOpenbuildout.cfgwith your favorite text editor and change it like
indicated below:[buildout]
...
develop =
  src/iw.sitestatRun your buildout, you’re done. Your Subversion working copy ofiw.sitestatshould take over the egg.ConfigurationSite wide configurationGo to theSitestatconfiguration panel. This configuration panel is
self explanative for people who have basic skills in Sitestat
settings. Please refer to your Sitestat sevice documentation for terms
in use in this control panel.Content item optionsEach content item has aSitestatthumbnail available to anybody who
has item modification permission, even if Sitestat connection is
desactivated in the above mentioned control panel. As for the global
config, the various option widgets are self explanative for people
familiar with Sitestat features.LimitationsAt this stage of development, we do not yet honour the following
Sitestat features:Adobe Flash decoration support.Forms decoration support.These features are not essential in the context of a Plone site since
Plone is not suited for Flash oriented sites, and Plone has its own
tools for forms support.Project home pagesAt plone.org:http://plone.org/products/iw.sitestatAt pypi:http://pypi.python.org/pypi/iw.sitestatSubversion repository:https://svn.plone.org/svn/collective/iw.sitestatUpgradesVisit in ZMI theportal_setupobject of your site, clickUpgradesand selectiw.sitestat:default. All is obvious from there.SupportAs stated above, we willneverprovide support on Sitestat services,
or whatever that’s covered by Nedstat commercial support. We only
supportiw.sitestatitself.TrackerYou may report bugs or ask for features in our tracker. See the
“tracker” link from the project home page at plone.org.Please read the rules written in the home page of the tracker before
reporting in the tracker. More specifically, please check that there
is no answer to your issue before filing anything.OthersYou may ask for further support (training, commercial support, …) atIngeniweb supportif you don’t find answers
to your questions in the tracker.Further documentationSee the other files in docs/*. In addition this component may have
other more specificREADME.txtfiles in its directory tree.More technical documentation may be found in docs/DESIGN.txt and
iw/sitestat/tests/*.txtMiscAbout LinguaPloneWe do not know ifiw.sitestatis LinguaPlone compliant. At this time
wedo notsynch automatically content item options in the various
translations of a content item. As LinguaPlone is supposed to override
standard Plone and Archetypes APIs, we do not consider the issues
raised when mixing LinguaPlone andiw.sitestatin the same site asiw.sitestatbugs. Anyway, sponsorship and contributions are welcome
to get all this working fine.CreditsMain sponsor:EDFMain developer:Gilles LenfantTranslationsFrench (fr):Gilles LenfantChanges1.0.0-beta2More documentation - end user and developer
[glenfant]Fixed unit tests
[glenfant]1.0.0-beta1first public release