[1591] | 1 | quintagroup.plonegooglesitemaps Installation |
---|
[1642] | 2 | ============================================ |
---|
[1591] | 3 | |
---|
[1642] | 4 | Buildout |
---|
| 5 | -------- |
---|
[1591] | 6 | |
---|
[1642] | 7 | To 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] | 37 | Traditional Zope 2 instance |
---|
| 38 | --------------------------- |
---|
[1634] | 39 | |
---|
[1642] | 40 | To install quintagroup.plonegooglesitemaps into the global Python environment (or a workingenv), |
---|
| 41 | using 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 |
---|
| 46 | should 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 |
---|
| 51 | should 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 | |
---|
| 62 | IMPORTANT |
---|
| 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 | |
---|
| 68 | * Catalog rebuilding: |
---|
| 69 | ------------------ |
---|
| 70 | * For quintagroup.plonegooglesitemaps >= v.1.2: |
---|
| 71 | catalog rebuilding will be made automatically, with updating *canonical_link* |
---|
| 72 | metadata *only*. |
---|
| 73 | * For quintagroup.plonegooglesitemaps < v.1.2: |
---|
| 74 | after installation portal_catalog rebuild needed. |
---|
| 75 | By default catalog NOT rebuilded. You may rebuild catalog in 2 ways: |
---|
| 76 | ** by hand: go to /<plone instance id>/portal_catalog/manage_catalogAdvanced |
---|
| 77 | and push *Update* button. |
---|
| 78 | ** allow catalog rebuilding on quintagroup.plonegooglesitemap installation. |
---|
| 79 | For that - set *UPDATE_CATALOG* property to *True* in |
---|
| 80 | quintagroup.plonegooglesitemaps.config python module. |
---|
| 81 | |
---|
| 82 | |
---|