source: products/quintagroup.plonegooglesitemaps/trunk/docs/INSTALL.txt @ 3664

Last change on this file since 3664 was 2426, checked in by mylan, 9 years ago

#131: Updated README, INSTALL files

  • Property svn:eol-style set to native
File size: 2.9 KB
RevLine 
[1591]1quintagroup.plonegooglesitemaps Installation
[1642]2============================================
[1591]3
[1642]4Buildout
5--------
[1591]6
[1642]7To install quintagroup.plonegooglesitemaps to your buildout-based project:
[1591]8
[1642]9* Add ``quintagroup.plonegooglesitemaps`` to the list of eggs to install::
[1591]10
11    [buildout]
12    ...
13    eggs =
14        ...
15        quintagroup.plonegooglesitemaps
16       
[1642]17* Tell the plone.recipe.zope2instance recipe to install a ZCML slug::
[1591]18
19    [instance]
20    recipe = plone.recipe.zope2instance
21    ...
22    zcml =
23        quintagroup.plonegooglesitemaps
[2248]24        quintagroup.plonegooglesitemaps-overrides
25
[1642]26* Re-run buildout, e.g. with::
[1591]27
28    $ ./bin/buildout
[2248]29
[1642]30* Restart the Zope server, e.g with the following command in the terminal::
31
32   $ ./bin/instance restart
33   
34* Install ``Plone Google Sitemaps`` with Quickinstaller in Plone (Site Setup -> Add/Remove Products)
[2248]35
36
[1642]37Traditional Zope 2 instance
38---------------------------
[1634]39
[1642]40To install quintagroup.plonegooglesitemaps into the global Python environment (or a workingenv),
41using a traditional Zope 2 instance, you can do this:
[1634]42
[1642]43* Copy ``quintagroup`` folder to your instance's ``/lib/python`` directory.
[1634]44
[1642]45* Create a file called ``quintagroup.plonegooglesitemaps-configure.zcml`` in your instance's ``/etc/package-includes`` directory. The file
46should only contain this::
[1634]47
[1642]48    <include package="quintagroup.plonegooglesitemaps" />
[1634]49
[2248]50* Create a file called ``quintagroup.plonegooglesitemaps-overrides.zcml`` in your instance's ``/etc/package-includes`` directory. The file
51should only contain this::
52
53    <include package="quintagroup.plonegooglesitemaps" file="overrides.zcml" />
54
[1642]55* Restart the Zope server, for example with the following command in the terminal::
56
57   $ ./bin/zopectl restart
58
59* Install ``Plone Google Sitemaps`` with Quickinstaller in Plone (Site Setup -> Add/Remove Products)
[1728]60
61
62IMPORTANT
63---------
64
[2248]65* *If you migrate* to quintagroup.plonegooglesitemaps >= v.1.2 - you MUST ADD overrides.zcml
66  slug to instance/buildout configuration, as mentioned in previous sections.
67
[2426]68* If you want to upgrade to newer version:
69  * Perform all steps but last one from *Buildout* or *Traditional Zope 2 instance* sections
70  * *Reinstall* ``Plone Google Sitemaps`` with Quickinstaller in Plone (Site Setup -> Add/Remove Products)
71
[2248]72* Catalog rebuilding:
73  ------------------
74  * For quintagroup.plonegooglesitemaps >= v.1.2:
75    catalog rebuilding will be made automatically, with updating *canonical_link*
76    metadata *only*.
77  * For quintagroup.plonegooglesitemaps < v.1.2:
78    after installation portal_catalog rebuild needed.
79    By default catalog NOT rebuilded. You may rebuild catalog in 2 ways:
80     ** by hand: go to /<plone instance id>/portal_catalog/manage_catalogAdvanced
81         and push *Update* button.
82     ** allow catalog rebuilding on quintagroup.plonegooglesitemap installation.
83        For that - set *UPDATE_CATALOG* property to *True* in
84        quintagroup.plonegooglesitemaps.config python module.
85
86
Note: See TracBrowser for help on using the repository browser.