jpl.ngtheme

JPL Next Generation Theme

These details have not been verified by PyPI

Project links

Development Status
- 4 - Beta
Environment
- Web Environment
Framework
- Plone
Intended Audience
- Science/Research
License
- Other/Proprietary License
Operating System
- OS Independent
Programming Language
- Python
Topic
- Internet :: WWW/HTTP
- Software Development :: Libraries :: Python Modules

Project description

This package, jpl.ngtheme provides the next generation theme for Plone websites hosted at the Jet Propulsion Laboratory (JPL). This theme turns your ordinary Plone site into one suitable for public-facing websites at JPL.

Requirements

The jpl.ngtheme package requires:

Plone 4.0, 4.1, or 4.2
Python 2.6 or 2.7
libxml2 2.6.26 or later (important!)
libxslt 1.1.26 or later (important!)

Installation

To install this theme, just include jpl.ngtheme as one of your installed eggs for your Plone site.

If you’re using a buildout, you can add jpl.ngtheme to the list of eggs in the plone.recipe.zope2instance recipe. For example:
```
[buildout]
...
eggs =
    ...
    jpl.ngtheme
    ...
```
If you’re using a “policy” project egg, just add jpl.ngtheme as a dependent egg.

For example:
```
setup(
    ...
    install_requires=[
        ...
        'jpl.ngtheme',
        ...
    ]
)
```

In either case, re-run the buildout and start your server.

There’s no need to include a “ZCML slug”, since this package advertises a z3c.autoinclude plugin for Plone. (If you don’t know what that means, then don’t worry about it.)

Activating the Theme

Once your server is running, you can activate the theme:

Log into your Plone site as a manager.
Click your name in the personal bar, and click “Site Setup”.
Click “Add-ons”.
Check the box by jpl.ngtheme and click “Activate”.

You may need to empty your browser cache and reload the page to see the new theme.

Setting Up the Webmaster

Public websites at JPL must tell who their webmasters are in the footer. With jpl.ngtheme, this is displayed automatically from the Plone Mail settings. To set this name:

Log into your Plone site as a manager.
Click your name in the personal bar, and click “Site Setup”.
Click “Mail”.
Enter the name of the webmaster under “Site ‘From’ name”.
Click “Save”.

Changing the Banner Image

The package jpl.ngtheme includes a generic banner image. To set a custom banner, create a new image in the PNG format; suggested size is 989×127 pixels (at 72 pixels per inch). Save the image into a file, then:

Log into your Plone site as a manager.
Click your name in the personal bar, and click “Site Setup”.
Click “Zope Management Interface”.
Click the portal_skins tool.
Click the jpl_ngtheme_custom_images folder.
Click logo.png.
Press “Customize”.
Across from the “File Data” heading, find and upload your new image file.

You may need to empty your browser cache and reload your site’s pages to see the new banner image.

Questions or Comments?

The jpl.ngtheme package was developed by Sean Kelly for the Jet Propulsion Laboratory. If you have any questions, comments, or would like to report a bug or request a new feature, please contact him.

Changelog

What follows is a history of changes in this package from release to release.

1.0.6 — 2012.5.24 — Post-Registration Blues

This release fixes the package metadata by updating the package’s “home page”. It also includes some additional package keywords.

1.0.5 — 2012.5.24 — Powered by Secret

This release:

Removes the “Powered by Plone & Python” colophon, per Tony Greicius.
Improves the installation instructions.

1.0.3 — 2011.7.28 — Layer Affinity

This release makes the viewlets in the theme stick to their own browser layer. Derived themes should likewise use this theme’s specific layer interface as a base.

1.0.2 — 2011.6.30 — Test Layer Cleanup

Fixes the name of the functional testing layer.
Makes the testing layer’s base be plone.app.theming’s base.
Removes unneeded call to install plone.app.theming as a “product”, which produced a disturbing—but harmless—error message.

1.0.1 — 2011.6.28 — Buffed

This release buffs out some of the rough edges of the 1.0.0 release by including missing dependencies. It also adds test layer fixtures as well as some integration tests of the viewlets.

1.0.0 — 2011.6.27 — Initial

This is the FCS of the JPL Next Generation theme.

0.0.0dev (unreleased)

Initial (unreleased) release

Copyright

The Software is owned by Caltech/JPL and is protected by United States copyright laws and applicable international treaties and/or conventions. The United States Government may have prior rights to use some or all of the Software as determined under applicable contracts and license agreements with Caltech/JPL.

This software was developed at the Jet Propulsion Laboratory, an operating division of the California Institute of Technology and is not available for use by any person, organization, or other entity without prior, specific written permission.