Castle CMS Plone distribution main package
Project description
.. image:: https://www.wildcardcorp.com/logo.png
:height: 50
:width: 382
:alt: Original work by wildcardcorp.com
:scale: 50 %
|
For access to CastleCloud, our hosted CastleCMS service, or to request customizations and demos, please contact us at https://castlecms.io or https://wildcardcorp.com
info@wildcardcorp.com
+1 (715) 869-3440
=======================================
Welcome to the main Castle CMS package!
=======================================
This package includes a lot of customizations to default Plone and, without an installer,
this package won't be very useful.
Until there is an installer, here are some of the things you'll need:
- this version of plone.app.blocks: https://github.com/castlecms/plone.app.blocks
- this version of plone.app.registry: https://github.com/plone/plone.app.registry/pull/15
- Redis
- avconv (needs to be updated for ffmpeg again)
- ElasticSearch 2.3
- https://github.com/castlecms/elasticsearch-castle-scoring
- https://github.com/castlecms/castlehps installed for faster search integration
- Amazon S3 credentials
- Google Analytics API integration
- Plivo API
- reCAPTCHA key
Feature List
============
In addition to Plone standard features...
- Login/lockout support
- Content archival to Amazon S3 Storage
- Large files automatically moved to S3 storage
- Redis cache support
- Advanced content layout editor
- Improved management toolbar
- Intuitive content creation and organization
- Elasticsearch integration
- Search results are tuned by social media impact
- Search result pinning
- Celery task queue integration (asynchronous actions)
- PDF generation
- Video conversion
- Amazon S3 interaction
- copying and pasting of large batches of items
- deletion of large batches of items
- Advanced content tiles:
- maps
- videos
- audio
- sliders
- galleries
- table of contents
- Audio and video content
- Automatic conversion of videos to web compatible format
- Search weighting based on popularity using Google Analytics API
- Content alias management
- Disqus integration
- reCAPTCHA integration
- fullcalendar integration
- Business metadata
- Emergency notification system with SMS support
- Preview content
- Map content
- KML feeds
- Social media integration with
- Twitter, Facebook, Pinterest
- Etherpad collaborative spaces support
- Stripping metadata from files
- Ability to view the site as another user
- Audit log, user activity reports
- Session management and inspection
- Analytics dashboard
- De-duplication of uploaded images
- Trash can / recycle bin
- 2-factor authentication
Optional Dependencies
=====================
- install `argon2_cffi` to use more secure password hashing
Running tests
=============
Assuming you have buildout properly installed to run the tests:
.. code-block:: shell
Xvfb :99 &
Xvfb :99 -fp /usr/share/X11/fonts/misc -screen 0 1900x1900x24 &
export DISPLAY=:99
To access the running Selenium test server on port 55001:
.. code-block:: shell
ZSERVER_HOST=0.0.0.0 ./bin/test -s castle.cms
To specify custom Firefox binary to match versions:
.. code-block:: shell
FIREFOX_BINARY=/opt/firefox/firefox ./bin/test -s castle.cms
Non-Selenium tests:
.. code-block:: shell
./bin/test -s castle.cms -t \!selenium
Google Analytics Key File
-------------------------
- go to the Google API console
- create new credentials
- service account
- p12
- enable Analytics API api for credentials
- fill out email with email provided and p12 file in Castle API settings
- use email for email you want to access and add it as an authorized user for the account in Google Analytics
Cron jobs
=========
Castle uses many cron jobs that need to be setup.
Daily
-----
- ``bin/clean-plone-users``: removes disabled users
- ``bin/social-counts``: goes through all content and updates social media counts. Can be done monthly
- ``bin/content-popularity``: if GA setup, will get content statistics for popularity
Weekly
------
- ``bin/archive-content``: Archive content and send out content warnings about content that will be archived
- ``bin/empty-trash``: Delete items that have been in trash for 30 days
- ``bin/send-forced-publish-alert``: Send update to admins about content that was forced published
Processes
---------
- ``bin/twitter-monitor``: Monitor Twitter for mentions of your site
Export/Import
-------------
Castle provides a simple export/import mechanism that does not use transmogrifier.
You are still able to build your own custom transmogrifier pipelines to import/export
into castle; however, our scripts seem to work in a lot of cases to get your
content moved over to start working with.
Export
~~~~~~
Copy the export script into your existing site's main buildout folder of your site::
https://raw.githubusercontent.com/castlecms/castle.cms/master/castle/cms/_scripts/export-content.py
Then, to run the export script::
./bin/client1 run export-content.py --site-id=mysiteid --dir=./export
This is assuming that "client1" is an instance of your site and "mysiteid" is the
id of your install plone site.
To customize the export script so only parts of the site are exported,
you can change the final line in the script to a custom catalog query that only
pulls in the content you want to export.
Import
~~~~~~
First off, copy the exported directory that you did in the previous step to
the castle installation folder.
Next, copy the import script into your new castle site's main buildout folder::
https://raw.githubusercontent.com/castlecms/castle.cms/master/castle/cms/_scripts/importjson.py
Then, to run the import script::
./bin/client1 run importjson.py --site-id=mysiteid --export-directory=./export
This is assuming that "client1" is an instance of your site and "mysiteid" is the
id of your install plone site.
Tile display types
------------------
There are a few different tiles that castle provides that allow you to customize
the display type. The display type field is a way of providing a different
view onto the content.
Available display type tiles(listing with display type vocab id):
- Navigation(navigation)
- Existing content(existing)
- Gallery(gallery)
- Query Listing(querylisting)
Providing your own display types
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
There are 3 components to registering a display type for a tile:
- Display type class
- Page template
- ZCML registration
I know, probably too much but not a lot of thought has gone into how to make
this more simple for the developer at this point.
Example custom display type
~~~~~~~~~~~~~~~~~~~~~~~~~~~
We'll go through an example for the existing content tile
Display type class::
class MyTileView(BaseTileView):
name = 'myview'
preview = '++plone++castle/path/to/image.png'
order = 1
index = ViewPageTemplateFile('myview.pt')
tile_name = 'existing'
Then, the template::
<tal:wrap tal:define="utils view/tile/utils;
data view/tile/data;
df view/tile/display_fields;
idt data/image_display_type|string:landscape;
existing nocall: view/tile/content|nothing;
url python: utils.get_object_url(existing);
has_image python: 'image' in df and utils.has_image(existing);">
<h3><a href="${url}">${existing/Title}</a></h3>
</tal:wrap>
Finally, the ZCML to register it::
<adapter
name="existing.myview"
provides="castle.cms.interfaces.ITileView"
for="plone.dexterity.interfaces.IDexterityContent castle.cms.interfaces.ICastleLayer"
factory=".myview.MyTileView"
/>
Lead images
-----------
- all content has lead images
- lead images can be references to other images on the site
Castle upgrades
---------------
Right now, there is no way that is exposed nicely in site setup to run castle
upgrades.
To run upgrades::
- go to /manage on your plone site
- Then, portal_setup
- click the "Upgrades" tab
- select "castle.cms:default" and click "choose profile"
- from here, you should get a list of available upgrades to run
Changelog
=========
2.0.12 (2017-03-15)
-------------------
- Fix paste button not working and throwing unauthorized errors because of
missing csrf token. Fixes #19
[vangheem]
- Automatically detect image in content if no lead image is set. Fixes #28
[vangheem]
- Fix showing non-image content on lead image browse selector. Fixes #30
[vangheem]
- Be able to provide additional views for the existing content tile
[vangheem]
- Be able to specify upload location
[vangheem]
2.0.11 (2017-03-09)
-------------------
- Fix image focus point upgrade issue where it would request more images than
it should
[vangheem]
- Provide image_url for json feed
[vangheem]
- If commenting enabled on a folder, it will become the default for all children
in that folder.
[vangheem]
2.0.10 (2017-02-06)
-------------------
- Fix next/prev nav fragment to work with pages and site root
[vangheem]
- Fix fullcalendar issue with selecting text when one is dropped on page.
This requires building with mockup on fix-jquery-event-drag-compat branch
or master once it's merged
[vangheem]
- Override default Zope2 logging to log actual plone username in Z2.log
[vangheem]
2.0.9 (2017-01-23)
------------------
- Add automatic session refresh support
[vangheem]
2.0.8 (2017-01-21)
------------------
- Be able to provide your own google maps api key so that working with the
mapping widget works more consistently.
[vangheem]
- Use argon2 pw encryption scheme by default
[vangheem]
2.0.7 (2017-01-18)
------------------
- Fix previous release
2.0.6 (2017-01-18)
------------------
- Fix logged in event not recorder in the audit log correctly
[vangheem]
2.0.5 (2017-01-18)
------------------
New:
- Add new JSON feed type
[vangheem]
Fixes:
- Fix parsing querylisting selected-year query
[vangheem]
- Fix parsing querylisting Title/SearchableText query
[vangheem]
2.0.4 (2017-01-09)
------------------
- add rocket chat integration
[sam schwartz]
- fix issue where password reset wasn't sticking
[vangheem]
- make sure logout page shows login form
[vangheem]
- add clean-drafts script
[vangheem]
- add ping draft view so that the clean-drafts script knows not to clean a potentially
active draft
[vangheem]
2.0.3 (2016-12-20)
------------------
- Be able to pass in a site object to the render_content_core function for
layout aware items
[vangheem]
2.0.2 (2016-12-14)
------------------
- build resources
[vangheem]
2.0.1 (2016-12-14)
------------------
- fix ipod/ipad safari video background image issue
[robzonenet]
2.0.0 (2016-12-07)
------------------
- Initial public release
:height: 50
:width: 382
:alt: Original work by wildcardcorp.com
:scale: 50 %
|
For access to CastleCloud, our hosted CastleCMS service, or to request customizations and demos, please contact us at https://castlecms.io or https://wildcardcorp.com
info@wildcardcorp.com
+1 (715) 869-3440
=======================================
Welcome to the main Castle CMS package!
=======================================
This package includes a lot of customizations to default Plone and, without an installer,
this package won't be very useful.
Until there is an installer, here are some of the things you'll need:
- this version of plone.app.blocks: https://github.com/castlecms/plone.app.blocks
- this version of plone.app.registry: https://github.com/plone/plone.app.registry/pull/15
- Redis
- avconv (needs to be updated for ffmpeg again)
- ElasticSearch 2.3
- https://github.com/castlecms/elasticsearch-castle-scoring
- https://github.com/castlecms/castlehps installed for faster search integration
- Amazon S3 credentials
- Google Analytics API integration
- Plivo API
- reCAPTCHA key
Feature List
============
In addition to Plone standard features...
- Login/lockout support
- Content archival to Amazon S3 Storage
- Large files automatically moved to S3 storage
- Redis cache support
- Advanced content layout editor
- Improved management toolbar
- Intuitive content creation and organization
- Elasticsearch integration
- Search results are tuned by social media impact
- Search result pinning
- Celery task queue integration (asynchronous actions)
- PDF generation
- Video conversion
- Amazon S3 interaction
- copying and pasting of large batches of items
- deletion of large batches of items
- Advanced content tiles:
- maps
- videos
- audio
- sliders
- galleries
- table of contents
- Audio and video content
- Automatic conversion of videos to web compatible format
- Search weighting based on popularity using Google Analytics API
- Content alias management
- Disqus integration
- reCAPTCHA integration
- fullcalendar integration
- Business metadata
- Emergency notification system with SMS support
- Preview content
- Map content
- KML feeds
- Social media integration with
- Twitter, Facebook, Pinterest
- Etherpad collaborative spaces support
- Stripping metadata from files
- Ability to view the site as another user
- Audit log, user activity reports
- Session management and inspection
- Analytics dashboard
- De-duplication of uploaded images
- Trash can / recycle bin
- 2-factor authentication
Optional Dependencies
=====================
- install `argon2_cffi` to use more secure password hashing
Running tests
=============
Assuming you have buildout properly installed to run the tests:
.. code-block:: shell
Xvfb :99 &
Xvfb :99 -fp /usr/share/X11/fonts/misc -screen 0 1900x1900x24 &
export DISPLAY=:99
To access the running Selenium test server on port 55001:
.. code-block:: shell
ZSERVER_HOST=0.0.0.0 ./bin/test -s castle.cms
To specify custom Firefox binary to match versions:
.. code-block:: shell
FIREFOX_BINARY=/opt/firefox/firefox ./bin/test -s castle.cms
Non-Selenium tests:
.. code-block:: shell
./bin/test -s castle.cms -t \!selenium
Google Analytics Key File
-------------------------
- go to the Google API console
- create new credentials
- service account
- p12
- enable Analytics API api for credentials
- fill out email with email provided and p12 file in Castle API settings
- use email for email you want to access and add it as an authorized user for the account in Google Analytics
Cron jobs
=========
Castle uses many cron jobs that need to be setup.
Daily
-----
- ``bin/clean-plone-users``: removes disabled users
- ``bin/social-counts``: goes through all content and updates social media counts. Can be done monthly
- ``bin/content-popularity``: if GA setup, will get content statistics for popularity
Weekly
------
- ``bin/archive-content``: Archive content and send out content warnings about content that will be archived
- ``bin/empty-trash``: Delete items that have been in trash for 30 days
- ``bin/send-forced-publish-alert``: Send update to admins about content that was forced published
Processes
---------
- ``bin/twitter-monitor``: Monitor Twitter for mentions of your site
Export/Import
-------------
Castle provides a simple export/import mechanism that does not use transmogrifier.
You are still able to build your own custom transmogrifier pipelines to import/export
into castle; however, our scripts seem to work in a lot of cases to get your
content moved over to start working with.
Export
~~~~~~
Copy the export script into your existing site's main buildout folder of your site::
https://raw.githubusercontent.com/castlecms/castle.cms/master/castle/cms/_scripts/export-content.py
Then, to run the export script::
./bin/client1 run export-content.py --site-id=mysiteid --dir=./export
This is assuming that "client1" is an instance of your site and "mysiteid" is the
id of your install plone site.
To customize the export script so only parts of the site are exported,
you can change the final line in the script to a custom catalog query that only
pulls in the content you want to export.
Import
~~~~~~
First off, copy the exported directory that you did in the previous step to
the castle installation folder.
Next, copy the import script into your new castle site's main buildout folder::
https://raw.githubusercontent.com/castlecms/castle.cms/master/castle/cms/_scripts/importjson.py
Then, to run the import script::
./bin/client1 run importjson.py --site-id=mysiteid --export-directory=./export
This is assuming that "client1" is an instance of your site and "mysiteid" is the
id of your install plone site.
Tile display types
------------------
There are a few different tiles that castle provides that allow you to customize
the display type. The display type field is a way of providing a different
view onto the content.
Available display type tiles(listing with display type vocab id):
- Navigation(navigation)
- Existing content(existing)
- Gallery(gallery)
- Query Listing(querylisting)
Providing your own display types
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
There are 3 components to registering a display type for a tile:
- Display type class
- Page template
- ZCML registration
I know, probably too much but not a lot of thought has gone into how to make
this more simple for the developer at this point.
Example custom display type
~~~~~~~~~~~~~~~~~~~~~~~~~~~
We'll go through an example for the existing content tile
Display type class::
class MyTileView(BaseTileView):
name = 'myview'
preview = '++plone++castle/path/to/image.png'
order = 1
index = ViewPageTemplateFile('myview.pt')
tile_name = 'existing'
Then, the template::
<tal:wrap tal:define="utils view/tile/utils;
data view/tile/data;
df view/tile/display_fields;
idt data/image_display_type|string:landscape;
existing nocall: view/tile/content|nothing;
url python: utils.get_object_url(existing);
has_image python: 'image' in df and utils.has_image(existing);">
<h3><a href="${url}">${existing/Title}</a></h3>
</tal:wrap>
Finally, the ZCML to register it::
<adapter
name="existing.myview"
provides="castle.cms.interfaces.ITileView"
for="plone.dexterity.interfaces.IDexterityContent castle.cms.interfaces.ICastleLayer"
factory=".myview.MyTileView"
/>
Lead images
-----------
- all content has lead images
- lead images can be references to other images on the site
Castle upgrades
---------------
Right now, there is no way that is exposed nicely in site setup to run castle
upgrades.
To run upgrades::
- go to /manage on your plone site
- Then, portal_setup
- click the "Upgrades" tab
- select "castle.cms:default" and click "choose profile"
- from here, you should get a list of available upgrades to run
Changelog
=========
2.0.12 (2017-03-15)
-------------------
- Fix paste button not working and throwing unauthorized errors because of
missing csrf token. Fixes #19
[vangheem]
- Automatically detect image in content if no lead image is set. Fixes #28
[vangheem]
- Fix showing non-image content on lead image browse selector. Fixes #30
[vangheem]
- Be able to provide additional views for the existing content tile
[vangheem]
- Be able to specify upload location
[vangheem]
2.0.11 (2017-03-09)
-------------------
- Fix image focus point upgrade issue where it would request more images than
it should
[vangheem]
- Provide image_url for json feed
[vangheem]
- If commenting enabled on a folder, it will become the default for all children
in that folder.
[vangheem]
2.0.10 (2017-02-06)
-------------------
- Fix next/prev nav fragment to work with pages and site root
[vangheem]
- Fix fullcalendar issue with selecting text when one is dropped on page.
This requires building with mockup on fix-jquery-event-drag-compat branch
or master once it's merged
[vangheem]
- Override default Zope2 logging to log actual plone username in Z2.log
[vangheem]
2.0.9 (2017-01-23)
------------------
- Add automatic session refresh support
[vangheem]
2.0.8 (2017-01-21)
------------------
- Be able to provide your own google maps api key so that working with the
mapping widget works more consistently.
[vangheem]
- Use argon2 pw encryption scheme by default
[vangheem]
2.0.7 (2017-01-18)
------------------
- Fix previous release
2.0.6 (2017-01-18)
------------------
- Fix logged in event not recorder in the audit log correctly
[vangheem]
2.0.5 (2017-01-18)
------------------
New:
- Add new JSON feed type
[vangheem]
Fixes:
- Fix parsing querylisting selected-year query
[vangheem]
- Fix parsing querylisting Title/SearchableText query
[vangheem]
2.0.4 (2017-01-09)
------------------
- add rocket chat integration
[sam schwartz]
- fix issue where password reset wasn't sticking
[vangheem]
- make sure logout page shows login form
[vangheem]
- add clean-drafts script
[vangheem]
- add ping draft view so that the clean-drafts script knows not to clean a potentially
active draft
[vangheem]
2.0.3 (2016-12-20)
------------------
- Be able to pass in a site object to the render_content_core function for
layout aware items
[vangheem]
2.0.2 (2016-12-14)
------------------
- build resources
[vangheem]
2.0.1 (2016-12-14)
------------------
- fix ipod/ipad safari video background image issue
[robzonenet]
2.0.0 (2016-12-07)
------------------
- Initial public release
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
castle.cms-2.0.12.tar.gz
(6.3 MB
view hashes)
