Metadata-Version: 2.0
Name: brasil.gov.portal
Version: 2.0a4
Summary: Implementação Modelo da Identidade Digital de Governo
Home-page: https://github.com/plonegovbr/brasil.gov.portal
Author: PloneGov.BR
Author-email: gov@plone.org.br
License: GPLv2
Keywords: plone .gov.br identidade_digital egov
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.3
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: JavaScript
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Multimedia
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Provides-Extra: test
Provides-Extra: migration
Requires-Dist: AccessControl
Requires-Dist: Acquisition
Requires-Dist: Products.CMFCore
Requires-Dist: Products.CMFDefault
Requires-Dist: Products.CMFPlone
Requires-Dist: Products.Doormat (>0.7)
Requires-Dist: Products.GenericSetup
Requires-Dist: Products.PloneFormGen
Requires-Dist: Products.PloneKeywordManager
Requires-Dist: Products.RedirectionTool
Requires-Dist: Products.TinyMCE
Requires-Dist: brasil.gov.agenda
Requires-Dist: brasil.gov.barra
Requires-Dist: brasil.gov.portlets
Requires-Dist: brasil.gov.temas
Requires-Dist: brasil.gov.tiles (>=1.4b1)
Requires-Dist: brasil.gov.vcge[dexterity]
Requires-Dist: collective.cover (>1.3b1)
Requires-Dist: collective.fingerpointing
Requires-Dist: collective.jsonmigrator
Requires-Dist: collective.lazysizes
Requires-Dist: collective.liveblog
Requires-Dist: collective.monkeypatcher
Requires-Dist: collective.nitf (>=2.1b2)
Requires-Dist: collective.polls
Requires-Dist: collective.upload
Requires-Dist: five.grok
Requires-Dist: five.pt
Requires-Dist: lxml
Requires-Dist: plone.api (>1.1.0)
Requires-Dist: plone.app.contenttypes (>=1.1.1)
Requires-Dist: plone.app.controlpanel
Requires-Dist: plone.app.dexterity
Requires-Dist: plone.app.layout
Requires-Dist: plone.app.portlets
Requires-Dist: plone.app.search
Requires-Dist: plone.app.theming
Requires-Dist: plone.app.upgrade
Requires-Dist: plone.browserlayer
Requires-Dist: plone.contentrules
Requires-Dist: plone.dexterity
Requires-Dist: plone.directives.form
Requires-Dist: plone.indexer
Requires-Dist: plone.memoize
Requires-Dist: plone.namedfile
Requires-Dist: plone.protect (>=3.0.26)
Requires-Dist: plone.registry
Requires-Dist: plone.restapi
Requires-Dist: plone.supermodel
Requires-Dist: plone.tiles
Requires-Dist: sc.contentrules.groupbydate
Requires-Dist: sc.contentrules.layout
Requires-Dist: sc.contentrules.metadata
Requires-Dist: sc.embedder
Requires-Dist: sc.photogallery
Requires-Dist: sc.social.like
Requires-Dist: setuptools
Requires-Dist: webcouturier.dropdownmenu
Requires-Dist: z3c.jbot
Requires-Dist: z3c.unconfigure
Requires-Dist: zope.component
Requires-Dist: zope.event
Requires-Dist: zope.interface
Requires-Dist: zope.lifecycleevent
Requires-Dist: zope.schema
Provides-Extra: migration
Requires-Dist: collective.jsonmigrator; extra == 'migration'
Requires-Dist: collective.transmogrifier; extra == 'migration'
Requires-Dist: plone.app.transmogrifier; extra == 'migration'
Requires-Dist: transmogrify.dexterity; extra == 'migration'
Provides-Extra: test
Requires-Dist: Products.GenericSetup; extra == 'test'
Requires-Dist: brasil.gov.agenda; extra == 'test'
Requires-Dist: collective.cover; extra == 'test'
Requires-Dist: plone.app.robotframework; extra == 'test'
Requires-Dist: plone.app.testing[robot]; extra == 'test'
Requires-Dist: plone.testing; extra == 'test'
Requires-Dist: plonetheme.sunburst; extra == 'test'
Requires-Dist: robotframework-wavelibrary; extra == 'test'
Requires-Dist: robotsuite; extra == 'test'
Requires-Dist: transaction; extra == 'test'
Requires-Dist: zope.publisher; extra == 'test'
Requires-Dist: zope.viewlet; extra == 'test'

*******************************************************************
.gov.br: Portal Padrão da Identidade Digital do Governo
*******************************************************************

.. contents:: Conteúdo
   :depth: 2

Introdução
----------

Este pacote provê configurações para implementação da Identidade Digital de Governo em sites Plone do Governo da República Federativa do Brasil.

O desenvolvimento deste pacote foi feito como parte da iniciativa `Portal Padrão <http://portalpadrao.plone.org.br>`_ da comunidade `PloneGov.Br <http://www.softwarelivre.gov.br/plone>`_.

Requisitos
----------

Para uso deste pacote, seu site deve ter sido construído com:

    * Plone 4.3.15
    * Pinagem correta das `dependências <https://github.com/plonegovbr/brasil.gov.portal/blob/master/setup.py#L45>`_ do ``brasil.gov.portal``: cada release possui um ``versions.cfg`` específico em `portalpadrao.release <https://github.com/plonegovbr/portalpadrao.release>`_. **Atenção**: Leia atentamente `a seção sobre como escolher o seu arquivo de versões de release <https://github.com/plonegovbr/portalpadrao.release/#user-content-como-escolher-corretamente-o-arquivo-de-versões-de-um-release>`_ para entender qual versão usar.

Recomendamos a leitura do `documento <http://identidade-digital-de-governo-plone.readthedocs.org/en/latest/>`_ sobre a instalação deste pacote.

Estado deste pacote
-------------------

O **brasil.gov.portal** tem testes automatizados e, a cada alteração em seu
código os testes são executados pelo serviço Travis.

O estado atual dos testes, a cobertura de código e o número de downloads deste pacote podem ser vistos nas imagens a seguir:

.. image:: http://img.shields.io/pypi/v/brasil.gov.portal.svg
    :target: https://pypi.python.org/pypi/brasil.gov.portal

.. image:: https://img.shields.io/pypi/dm/brasil.gov.portal.svg
    :target: https://pypi.python.org/pypi/brasil.gov.portal

.. image:: https://img.shields.io/travis/plonegovbr/brasil.gov.portal/master.svg
    :target: http://travis-ci.org/plonegovbr/brasil.gov.portal

.. image:: https://img.shields.io/coveralls/plonegovbr/brasil.gov.portal/master.svg
    :target: https://coveralls.io/r/plonegovbr/brasil.gov.portal

Instalação
----------

Para habilitar a instalação deste produto em um ambiente que utilize o
buildout:

1. Editar o arquivo buildout.cfg (ou outro arquivo de configuração) e
   adicionar o pacote ``brasil.gov.portal`` à lista de eggs da instalação::

        [buildout]
        ...
        eggs =
            brasil.gov.portal

2. Editar o arquivo ``buildout.cfg`` (ou outro arquivo de configuração)
   referenciando o uso do versions.cfg de acordo com o release presente em
   `portalpadrao.release <https://github.com/plonegovbr/portalpadrao.release>`_

3. Após alterar o arquivo de configuração é necessário executar
   ''bin/buildout'', que atualizará sua instalação.

4. Reinicie o Plone

5. Adicione um novo site Plone.

Rodando o buildout de uma tag antiga do pacote
----------------------------------------------

Para atender ao relato de ter vários jobs de integração contínua em pacotes brasil.gov.* (ver https://github.com/plonegovbr/portalpadrao.release/issues/11), no fim da seção extends do buildout.cfg de todos os pacotes brasil.gov.* temos a seguinte linha:

.. code-block:: cfg

    https://raw.githubusercontent.com/plonegovbr/portal.buildout/master/buildout.d/versions.cfg

Hoje, esse arquivo contém sempre as versões pinadas de um release a ser lançado. Por esse motivo, quando é feito o checkout de uma tag mais antiga provavelmente você não conseguirá rodar o buildout. Dessa forma, após fazer o checkout de uma tag antiga, recomendamos que adicione, na última linha do extends, o arquivo de versões do IDG compatível com aquela tag, presente no repositório https://github.com/plonegovbr/portalpadrao.release/.

Exemplo: você clonou o repositório do brasil.gov.portal na sua máquina, e deu checkout na tag 1.0.5. Ao editar o buildout.cfg, ficaria dessa forma, já com a última linha adicionada:

.. code-block:: cfg

    extends =
        https://raw.github.com/collective/buildout.plonetest/master/test-4.3.x.cfg
        https://raw.github.com/collective/buildout.plonetest/master/qa.cfg
        http://downloads.plone.org.br/release/1.0.4/versions.cfg
        https://raw.githubusercontent.com/plonegovbr/portal.buildout/master/buildout.d/versions.cfg
        https://raw.githubusercontent.com/plone/plone.app.robotframework/master/versions.cfg
        https://raw.githubusercontent.com/plonegovbr/portalpadrao.release/master/1.0.5/versions.cfg

Para saber qual arquivo de versões é compatível, no caso do brasil.gov.portal, é simples pois é a mesma versão (no máximo um bug fix, por exemplo, brasil.gov.portal é 1.1.3 e o arquivo de versão é 1.1.3.1). Para os demais pacotes, recomendamos comparar a data da tag do pacote e a data nos changelog entre uma versão e outra para adivinhar a versão compatível.

Sobrescrita de traduções do domínio plone
-----------------------------------------

Se você tem um produto que tem como dependência o brasil.gov.portal e precisa sobrescrever traduções do domínio plone nesse produto, sua diretiva ```<i18n:registerTranslations directory="locales" />``` deve vir antes da diretiva ```<includeDependencies package="." />```, ou de qualquer outra diretiva que carrege o ZCML do brasil.gov.portal. O seu configure.zcml deve ficar assim:

.. code-block:: xml

    <configure
        xmlns="http://namespaces.zope.org/zope"
        xmlns:five="http://namespaces.zope.org/five"
        xmlns:i18n="http://namespaces.zope.org/i18n"
        i18n_domain="meu.produto">

      <i18n:registerTranslations directory="locales" />

      <includeDependencies package="." />

      ...
   </configure>

O ZCML do brasil.gov.portal carrega o ZCML do Products.CMFPlone, que por sua vez carrega o ZCML do plone.app.locales. Assim o locales do seu produto precisa ser carregado antes do ZCML do  brasil.gov.portal para que as traduções do seu produto possam sobrescrever às do Plone.

Contribuidores
-----------------

O ``brasil.gov.portal`` não seria possível sem a contribuição das seguintes pessoas:

- André Nogueira
- Cleber J. Santos
- Danilo Barbato
- Érico Andrei
- Héctor Velarde
- Felipe Duardo
- Rennan Rodrigues
- Rodrigo Ferreira de Souza
- Winston Ferreira

Para os testes do tipo áudio utilizamos o arquivo disponível no `Wikimedia Commons <http://commons.wikimedia.org/wiki/File:Thunder.ogg>`_

Para os testes do tipo Conteúdo Externo utilizamos o `arquivo disponível na Wikipedia <http://en.wikipedia.org/wiki/Clube_Atl%C3%A9tico_Juventus#mediaviewer/File:Ju_Jovem.JPG>`_

Changelog
---------

2.0a4 (2018-06-06)
^^^^^^^^^^^^^^^^^^

- Adiciona suporte para gestão de tags.
  [hvelarde]

- Remove dependência no plone4.csrffixes.
  [hvelarde]

- Adiciona um viewlet para relatórios de erros;
  é preciso criar um formulário de contato com id ``relatar-erros`` na raiz do site para utilizar este recurso.
  [hvelarde, claytonc]

- Atualiza as traduções a português brasileiro e espanhol.
  [hvelarde]

- Revisa a view de galeria de fotos e atualiza a lista de dimensões de imagens validas.
  [rodfersou]

- Corrige o viewlet services responsável pelos links de destaques.
  [claytonc]

- Adiciona um configlet para gerenciar os links no portal tabs.
  [claytonc]

- Adicionado tipo de conteúdo ``Infografic``;
  por enquanto é simplesmente um clone do tipo de conteúdo ``Image``.
  [hvelarde]


2.0a3 (2018-02-28)
^^^^^^^^^^^^^^^^^^

- Atualiza código para usar os decoradores ``implementer`` e ``adapter`` da ZCA.
  [hvelarde]

- Corrige ``icon_expr`` dos tipos de conteúdo definidos no pacote.
  [hvelarde]

- Corrige as permissões ``brasil.gov.portal: Add MPEG File`` e ``brasil.gov.portal: Add OGG File``:
  um usuário com papel "Editor" não deve poder adicionar conteúdo.
  [hvelarde]

- Atualizado plone.restapi à versão 1.1.0.
  [hvelarde]

- Atualizado brasil.gov.barra à versão 1.2.3.
  [hvelarde]

- Atualizado brasil.gov.temas à versão 2.0a4.
  [hvelarde]

- Corrige alinhamento do topo quando não informada primeira linha do título.
  [rodfersou]

- Habilita a busca de objetos de tipo ``sc.embedder``.
  [hvelarde]

2.0a2 (2018-01-11)
^^^^^^^^^^^^^^^^^^

- Atualizado sc.social.like à versão 2.13b3.
  [hvelarde]

- Remove monkey patches relacionados à atualização do plone.app.contenttypes.
  [hvelarde]

- Corrige configuração padrão do sc.social.like.
  [hvelarde]

- Adiciona patch para o widget de campos ordenados não engolir opções com mesmo nome (refs. `z3c.form#76 <https://github.com/zopefoundation/z3c.form/pull/76>`_).
  [rodfersou]

- Evita ``KeyError`` nos resultados da busca provocado por verbetes inexistentes.
  [hvelarde]


2.0a1 (2017-12-27)
^^^^^^^^^^^^^^^^^^

- Atualizado brasil.gov.vcge à versão 2.0.2 (ainda não é possível a migração de 1.x).
  [hvelarde]

- Adiciona webcouturier.dropdownmenu ao IDG;
  habilita menus dropdown para navegação global.
  [hvelarde]

- Implementa importação de conteúdo usando formato JSON e collective.transmogrifier.
  [hvelarde]

- Remove customizações dos templates do collective.nitf.
  [hvelarde]

- O viewlet ``global_sections`` é visível novamente.
  [rodfersou]

- Move estilos para o pacote brasil.gov.temas.
  [rodfersou]

- Remove criação de estrutura e conteúdo iniciais.
  [hvelarde]

- Remove dependência no collective.z3cform.widgets.
  [hvelarde]

- Removidos upgrade steps anteriores a v10803.
  [hvelarde]


