plonetheme.onegov

HomePage: http://www.4teamwork.ch

Author: Julian Infanger

Download: https://pypi.python.org/packages/source/p/plonetheme.onegov/plonetheme.onegov-1.2.3.zip

        plonetheme.onegov
=================

This is the default theme for all OneGov Plone modules (http://onegov.ch).

.. image:: https://raw.github.com/OneGov/plonetheme.onegov/master/docs/screenshot_onegov.png

**Important** this package doesn't work with python 2.6, it requires at least python 2.7

Usage
-----

- Add ``plonetheme.onegov`` to your buildout configuration:

::

    [instance]
    eggs +=
        plonetheme.onegov

- Install the generic import profile.

Features
--------
- Customize styles in control panel.
- Responsive design for tablets and smartphones
- Special path bar with children


Layout customizations
---------------------

Theme is SCSS based and styles most things with variables which can easily be customized
in a control panel.

Just visit the customization view: http://localhost:8080/Plone/customstyles_form

Here are some examples how the Layout can be customized:

.. image:: https://raw.github.com/OneGov/plonetheme.onegov/master/docs/screenshot_zg_ch.png

.. image:: https://raw.github.com/OneGov/plonetheme.onegov/master/docs/screenshot_menzingen.png

.. image:: https://raw.github.com/OneGov/plonetheme.onegov/master/docs/screenshot_custom.png


Additional SCSS
---------------

You can easily register custom SCSS files in your addon package using ZCML, if you need to customize
more than available through the web:

.. code:: xml

    <configure
        xmlns:theme="http://namespaces.zope.org/plonetheme.onegov">

        <include package="plonetheme.onegov" />
        <theme:add_scss path="resources/custom.scss" />

    </configure>

The SCSS files can also be restricted to a specific context interface or a specific request layer.
Be aware that the context interface applies to the context the styles are rendered on, which is either
the Plone site root or an `INavigationRoot` object.

.. code:: xml

    <configure
        xmlns:theme="http://namespaces.zope.org/plonetheme.onegov">

        <include package="plonetheme.onegov" />
        <theme:add_scss
            path="resources/custom.scss"
            for="my.package.interfaces.ISubsite"
            layer="my.package.interfaces.IMyPackageLayer" />

    </configure>

Special path bar
----------------
For another fast way to navigate between content, this theme includes a special path bar, which shows the breadcrumb's children.
This behavior can be disabled in the plone.app.registry, using the setting ``plonetheme.onegov.flyout_breadcrumbs``.

.. image:: https://raw.github.com/OneGov/plonetheme.onegov/master/docs/screenshot_flyout_breadcrumbs.png


Links
-----

- Github project repository: https://github.com/OneGov/plonetheme.onegov
- Issue tracker: https://github.com/OneGov/plonetheme.onegov/issues
- Continuous integration: https://jenkins.4teamwork.ch/search?q=plonetheme.onegov


Copyright
---------

This package is copyright by `4teamwork <http://www.4teamwork.ch/>`_.

``plonetheme.onegov`` is licensed under GNU General Public License, version 2.

Changelog
=========

1.2.3 (2014-04-14)
------------------

- Append "/view" to objects in left navigation if they are in the
  'typesUseViewActionInListings' property.
  [Julian Infanger]


1.2.2 (2014-04-14)
------------------

- Added styles for news archive portlet.
  [Julian Infanger]


1.2.1 (2014-04-08)
------------------

- BugFix: ftw.subsite logo integration use plone.scaling to create the logo
  url. This also fixes a traversal Issue with the virtualHostMonster.
  [mathias.leimgruber]

- Added missing dependency to setup.py.
  [Julian Infanger]

- Fixed styles of theming controlpanel.
  [Julian Infanger]

- Updated styles for seantis.dir.events release 1.1.
  [Marc Sommerhalder]

- Fixed seantis.dir.events styling.
  [Marc Sommerhalder]


1.2.0 (2014-03-31)
------------------

- Always hide ajax spinner.
  [Julian Infanger]

- Replaced inline css with a browserview returning the theme css.
  This allows to cache the CSS efficient.
  [Julian Infanger]

- Optimized accessibility:
  - lang attribute in HTML
  - use right doctype
  - move styles and script tags from body to head
  [Julian Infanger]