Как устанавливать дополнительные продукты?

Внимание! Установку новых продуктов рекомендуется производить на тестовом сервере.  Если вы работаете на боевом сервере, то сделайте бекап!

Немного определений

- конфигурационный файл для скрипта компиляции Plone. Все изменения в этом файле начинают действовать после перезапуска  скрипта.

buildout - скрипт сборки и компиляции Plone.

продукт - так называются любые адд-оны для Plone. Они могут добавлять новую функциональность (например, блог), новые типы контента (например,  RichDocument) или новую тему дизайна. 

яйца, егг-пакеты(eggs) - это упакованные особым образом python пакеты. Все, что вам нужно - это знать имя пакета, а buildout сам найдет откуда его скачать. 

традиционные продукты - это не еггофицированные продукты, упакованные старым способом. При установке такого продукта вы должны предварительно установить все его зависимости. 

Как определить тип пакета?

Внимание! Ниже даны инструкции по стандартной установке продуктов. Однако, иногда для успешной инсталляции продукта необходимо выполнить дополнительные действия. Обычно об этом написано в файле README.txt в корне пакета.

Установка егг-пакетов

1. Выберите на plone.org/products или Python Package Index: PyPI нужный продукт

2. Найдите файл buildout.cfg и проверьте, что он доступен на запись.

Если вы использовали инсталлятор для Windows, то файл можно найти  в директории установки Plone (c:\Program Files\Plone или c:\Plone). На Mac или Linux это может быть любое место, но обычно в подкаталоге  zinstance директории установки.

3. Откройте buildout.cfg в любимом редакторе

4. Добавить свой продукт в секцию  eggs

Прокрутите вниз файл пока не увидите слово eggs.

ДЛЯ ВСЕХ ПРОДУКТОВ: Добавьте имя продукта в список. Каждое имя продукта начинается с новой строки.

Если имя продукта начинается со слова Products (например, Products.PloneFormGen), то больше редактировать файл не нужно и можно переходить к следующему шагу.

Если имя продукта начинается с другого слова (например, plonetheme.kiss), то вы должны найти дальше в файле buildout.cfg секцию zcml и добавить тоже самое имя в конец списка с новой строки.

Например:

[buildout] 
... 
eggs = 
    ... 
    plonetheme.keepitsimple
    ... 
... 
[instance] 
... 

zcml = 
    ... 
    plonetheme.keepitsimple
...

 6. Убедитесь, что ваш сайт не запущен

Перед запуском скрипта сборки важно убедиться, что Plone остановлен. Для этого зайдите в директорию, в которой находится инстанс (обычно это zinstance в директории установки Plone) и выполните в консоле:

7. Запустить скрипт сборки

Находясь в той же директории, выполните в консоле: