Quando estamos trabalhando com Plone temos duas maneiras de manter nosso portal. Você pode acessar a ZMI (Zope Management Interface) e criar/atualizar o que desejamos pela interface web (não recomendado) ou fazer isso pelo filesystemcriando um produto Plone para que possamos instalá-lo e fazer nossas customizações.
Vamos aprender a criar nosso próprio produto Plone.
O Mr. Bob
O mr.bob é uma ferramenta utilizada para gerar o esqueleto do nosso produto, ou seja, a estrutura de diretórios necessária para que ele seja compatível com o Plone e possamos utilizá-lo em nosso portal.
Temos duas formas de instalar o mr.bob. A primeira é através do buildout de nossa instalação Zope/Plone e a segunda é em um ambiente independente do Plone, utilizando o virtualenv por exemplo. Vamos abordar aqui apenas a instalação via buildout. Caso você queira instalar pelo virtualenv o processo é bem simples e pode ser visto no repositório no github do produto bobtemplates.plone.
Instalação do mr.bob via buildout
No arquivo buildout.cfg vamos fazer as seguintes alterações:
Na sessão [buildout], em “parts”, vamos adicionar uma referência a ferramenta:
|
1
2
3
4
5
|
[buildout]
...
parts =
...
mrbob
|
Logo abaixo, vamos criar a sessão [mrbob]:
|
1
2
3
4
5
|
[mrbob]
recipe = zc.recipe.egg
eggs =
mr.bob
bobtemplates.plone
|
Agora é só rodar o buildout para baixar e instalar o mr.bob:
|
1
|
$ ./bin/buildout -Nv
|
Como criar o produto?
Concluído o buildout, nós podemos acessar a pasta “src” (onde fica localizada os produtos) e executar o comando a seguir:
|
1
|
$ ../bin/mrbob -O meu.produto bobtemplates:plone_addon
|
Nosso amigo Mr. Bob irá fazer algumas perguntas tais como o tipo de pacote nós desejamos criar, um produto “básico”, para tipos de conteúdo Dexterity ou um produto de tema (Diazo).
Além disso você deverá responder algumas perguntas tais como nome do autor, email, username do github, descrição do pacote e versão do Plone na qual nosso produto será compatível.
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
bruno@src$ ../bin/mrbob -O meu.produto bobtemplates:plone_addon
Welcome to mr.bob interactive mode. Before we generate directory structure, some questions need to be answered.
Answer with a question mark to display help.
Values in square brackets at the end of the questions show the default value if there is no answer.
--> What kind of package would you like to create? Choose between 'Basic', 'Dexterity', and 'Theme'. [Basic]:
--> Author's name: Bruno Barbosa
--> Author's email: bsbruno1@gmail.com
--> Author's github username: brunobbbs
--> Package description [An add-on for Plone]: Produto de teste para post no blog
--> Plone version [4.3.6]: 5.0
Generated file structure at /home/bruno/Projects/plone5/zinstance/src/meu.produto
|
Se tudo deu certo, ele irá gerar uma estrutura similar a essa aqui:
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
|
.
├── bootstrap-buildout.py
├── buildout.cfg
├── CHANGES.rst
├── CONTRIBUTORS.rst
├── docs
│ ├── index.rst
│ ├── LICENSE.GPL
│ └── LICENSE.rst
├── MANIFEST.in
├── README.rst
├── setup.cfg
├── setup.py
├── src
│ └── meu
│ ├── __init__.py
│ └── produto
│ ├── browser
│ │ ├── configure.zcml
│ │ ├── __init__.py
│ │ ├── overrides
│ │ └── static
│ ├── configure.zcml
│ ├── __init__.py
│ ├── interfaces.py
│ ├── locales
│ │ ├── meu.produto.pot
│ │ └── update.sh
│ ├── profiles
│ │ ├── default
│ │ │ ├── browserlayer.xml
│ │ │ ├── metadata.xml
│ │ │ └── meuproduto_default.txt
│ │ └── uninstall
│ │ ├── browserlayer.xml
│ │ └── meuproduto_uninstall.txt
│ ├── setuphandlers.py
│ ├── testing.py
│ └── tests
│ ├── __init__.py
│ ├── robot
│ │ └── test_example.robot
│ ├── test_robot.py
│ └── test_setup.py
└── travis.cfg
|
Como instalar o produto?
Agora que nosso produto está criado e acessível em nosso diretório “src”, vamos configurá-lo no buildout e instalar em nosso portal.
Vamos acessar novamente o arquivo buildout.cfg e incluir a referência ao nosso produto recém criado na sessão [buildout], em “eggs” e “develop”:
|
1
2
3
4
5
6
7
8
9
|
[buildout]
...
eggs =
...
meu.produto
develop =
...
src/meu.produto
|
Concluído essa etapa vamos rodar o buildout novamente:
|
1
|
$ ./bin/buildout -Nv
|
Se tudo deu certo seu produto deverá estar disponível para instalação no painel de controle, em “Complementos”
Agora que você já sabe criar e instalar produtos Plone, nem pense mais em fazer modificações via ZMI. No produto nós podemos redistribuir nosso pacote facilmente, utilizá-lo em vários portais e fica muuuito mais fácil recuperar o estado original do seu portal caso precise instalar em outro ambiente e manter o controle de versões do seu código.
