Skip to main content

CSS and JS overrides for Plone

This product allows content managers to inject custom stylesheets and Javascript by adding a file to a folder. On that folder and its descendants, these will be added to the existing CSS/JS.

If you want to style a section of the site, Plone already provides ways to do that. Please read http://plone.org/documentation/kb/create-a-different-look-and-feel-for-different-sections-of-your-web-site-without-creating-new-skins for more info on that, and decide if you have a use for this product.

How to use

The main thing is to place a file called custom.css or custom.js (“custom files”) in a folder. These files will then be inserted in a special viewlet in the HTML HEAD section.

There are two ways to manage custom files:

Add a custom file using Plone

Add a Plone File (ATFile).

  • Prepare a custom.css or custom.js file

  • In Plone, go to the desired folder

  • Click the “Add item” menu

  • Select “File”

  • Upload the prepared file

The advantage of this method is that the familiar Plone interface can be used to upload the file. Its disadvantage is that the file can’t be modified: You’d prepare a new file locally and replace the existing one instead.

Also be aware that:

  • Plone files may be workflowed, depending on your site. If a custom file is private, it won’t be visible to visitors who aren’t logged in.

  • Plone files may show up in your navigation, depending on your site’s navigation settings.

Add a custom file using the ZMI

Add a Zope File.

  • Either:

    • In Plone, go to the desired folder and append manage_main to the URL, or

    • Go to the ZMI straight away, and go to the desired folder

  • Add a File, name it either custom.css or custom.js

    • You may choose to upload a locally prepared file.

  • Edit the file.

This method is more flexible: it is possible to edit the file through the web. However, the ZMI is more complex to use, and requires higher permissions, so this method is for power users.

Tested on

Plone 3, Plone 4

Warning

  • Incorrect CSS/JS may mess up your site.

Changes

1.0.3 (2011-03-15)

  • setup.py: add product URL, update keywords

  • Documentation

1.0.2 (2011-03-09)

  • Documentation

  • Register viewlets in all skins.

1.0.1 (2011-03-08)

First public release.

Release files for Products.CustomOverrides 1.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Products.CustomOverrides 1.0.3
File Size Uploaded
Products.CustomOverrides-1.0.3.zip 16.6 kB Details

Release files / Products.CustomOverrides-1.0.3.zip

Download URL Products.CustomOverrides-1.0.3.zip
Size 16.6 kB
Tags Source
SHA-256 checksum
How to use checksums
f56a3aef8f01cf0ba366e2a99af5ccb8d01e6836ac873187c3a3e5e3a65b3c46
BLAKE2b-256 checksum
How to use checksums
1415873bac03d5b4b6b3b2577c9cd5c0426b69f5148c9c70233f736aafa645f6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

1.0.3 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page