.. This README is meant for consumption by humans and pypi. Pypi can render rst files so please do not use Sphinx features.
If you want to learn more about writing documentation, please check out: http://docs.plone.org/about/documentation_styleguide.html
This text does not appear on pypi or github. It is a comment.
======================
collective.siteimprove
======================
This package is a Plone add-on that provides integration with
`siteimprove.com <http://siteimprove.com>`_, a service for maintaining and improving website
content. Siteimprove provides customers with automated scans of their websites
which check for content quality, accessibility compliance, SEO, and
performance. The add-on gives content editors immediate feedback on
the quality of pages that they publish, with a summary report provided
in a page overlay and links to more details. This lets Siteimprove
customers see problems while they are in the process of editing a page
on their Plone site, instead of getting emailed a report after the
fact and needing to click through links to fix things.
collective.siteimprove provides the integration with Siteimprove's
`CMS plugin <https://siteimprove.com/en-us/core-platform/integrations/cms-plugin/>`_
API that is required to provide these features. The only thing Plone
admins need to do is install the add-on and configure a Siteimprove
token.
For more information on using Siteimprove within Plone,
see `How to navigate the Siteimprove CMS Plugin
<https://support.siteimprove.com/hc/en-gb/articles/115000075451-How-to-navigate-the-Siteimprove-CMS-Plugin>`_.
Features
--------
- Control panel for requesting and saving a siteimprove.com token
- Siteimprove overlay button shows for authorized users on all default views
- Overlay button provides link to login/logoout to Siteimprove account
- Overlay button can show summary info for the domain or info for the page
you are on, for publicly visible content
- Overlay button provides link to manually trigger page recheck action
- Overlay button provides link to re-crawl site
- Publishing or saving a published page triggers recheck action
Customization
-------------
This add-on creates a new permission "collective.siteimprove: Use Siteimprove"
(zcml id "collective.siteimprove.UseSiteimprove") for viewing Siteimprove screens
and requesting content scans. This permission is assigned to the "Editor", "Reviewer",
"Site Administrator", and "Manager" roles by default. Those assignments can be
changed via the ZMI or custom code.
Installation
------------
Install collective.siteimprove by adding it to your buildout::
[buildout]
...
eggs =
collective.siteimprove
and then running ``bin/buildout``.
Install the Add-on from the Plone Add-ons control panel under Site Setup.
Then go to the Siteimprove control panel and request a new token
(or paste in an existing one), and save.
Contribute
----------
- Issue Tracker: https://github.com/collective/collective.siteimprove/issues
- Source Code: https://github.com/collective/collective.siteimprove
License
-------
The project is licensed under the GPLv2.
Contributors
============
- Jazkarta, info <at> jazkarta.com
- Witek, witekdev <at> github
- Alec Mitchell, alecpm <at> gmail.com
- Sally Kleinfeldt, skleinfeldt <at> jazkarta.com
- Bert Vanderbauwhede, batlock666 <at> gmail.com
Changelog
=========
1.0.6 (2020-07-09)
------------------
- Add option for public/canonical site url [alecpm]
- Python 3 compatibility [alecpm]
1.0.5 (2019-11-19)
------------------
- Documentation updates [sallyk]
1.0.4 (2019-11-15)
------------------
- Fix the save and cancel buttons in siteimprove controlpanel [batlock666]
- Update rolemap to grant Editor and Reviewer role to siteimprove functionality by default [witekdev]
- Update PYPI classifier. Tested with Plone 5.2
1.0.3 (2018-11-08)
------------------
- Documentation updates [sallyk]
1.0.2 (2018-09-19)
------------------
- Documentation updates [sallyk]
1.0.1 (2018-08-14)
------------------
- Use canonical url for input, domain and recheck functions [witekdev]
- Call input function on add/edit views, domain on all others [witekdev]
- Trigger recheck when object saved and publically visible or on any workflow transition [witekdev]
0.1a2 (2018-05-09)
------------------
- Call `input` method on visible page loads.
[alecpm]
0.1a1 (2018-05-09)
------------------
- Initial release.
[witekdev]