JSON based CMS for Universal Core
Project description
Installation of Unicore CMS
===========================
.. code-block:: bash
$ virtualenv ve
$ source ve/bin/activate
(ve)$ pip install -e .
Running Unicore CMS for local development
-----------------------------------------
This is a Pyramid_ application, that uses Elasticsearch and Redis.
For OS X we recommend you install Elasticsearch and Redis with Brew_:
.. code-block:: bash
$ brew install elasticsearch
$ brew install redis
Start Elasticsearch in a separate Terminal tab:
.. code-block:: bash
$ elasticsearch
Start Redis in a separate Terminal tab:
.. code-block:: bash
$ redis-server
For Linux install them with your package manager (apt, rpm, yum etc...)
and make sure it's running as a service.
Then start the server:
.. code-block:: bash
(ve)$ pserve development.ini --reload
It'll run happily with the stock ``development.ini`` file provided but
it will be without any content.
For a better experience, load a content repository:
.. code-block:: bash
(ve)$ git clone https://github.com/universalcore/unicore-cms-content-ffl-tanzania repo
(ve)$ eg-tools resync -c development.ini -m unicore.content.models.Category -f mappings/category.mapping.json -r true
(ve)$ eg-tools resync -c development.ini -m unicore.content.models.Page -f mappings/page.mapping.json
(ve)$ eg-tools resync -c development.ini -m unicore.content.models.Localisation -f mappings/localisation.mapping.json
Running Unicore CMS tests
-------------------------
.. code-block:: bash
(ve)$ pip install -r requirements-dev.txt
(ve)$ py.test cms
.. _Pyramid: http://docs.pylonsproject.org/en/latest/docs/pyramid.html
.. _Brew: http://brew.sh
CHANGELOG
=========
1.10.1
------
- Add endpoint for retreiving repo names
1.10.0
------
- Add marathon version info to health check
1.9.8
-----
- Fix parsing of result_per_page configuration option (it's passed in as a
string and needed to be parsed into an integer).
1.9.7
-----
- Fix bug that prevented the results_per_page configuration option
from having an effect on the number of pages displayed in a
category listing.
1.9.6
-----
- Add pagination to category listings
1.9.5
-----
- use latest version of elastic-git (pins elasticsearch==1.7.0)
1.9.4
-----
- Exclude health checks from GA analytics
1.9.3
-----
- Add uswgi to dependencies
1.9.0
-----
- Support remote repos via unicore.distribute.
- Remove auto-cloning of repo on startup.
1.8.1
-----
- Add fallbacks for unsupported languages
- Ensure GA Titles are specified for static pages
1.8.0
-----
- Add comments using unicore.comments.client
- Handle non-existent category in page and category views
- Add page/category title context to GA
1.7.1
-----
- pin cornice to 1.0.0
1.7.0
-----
- Add auth using unicore.hub.client
- pin cornice to 0.18.1
1.6.6
-----
- Remove cornice version pinning
1.6.5
-----
- Consistently convert ES objects to `elastic-git` model objects
1.6.4
-----
- Add localised logo support
1.6.3
-----
- Ensure detail page doesn't break for flat pages
1.6.2
-----
- Use latest changes of EG (Changes to Avro schema)
1.6.1
-----
- provide es host in fastforward
1.6.0
-----
- Add branded 404 page
- Allow reading of `es.host` from config
1.5.2
-----
- Refactor Search templates
1.5.1
-----
- Ensure list of languages in change page is sorted
1.5.0
-----
- Change language selector to allow featured languages
1.4.2
-----
- Allow querystring-less locale url
1.4.1
-----
- Fix tests breaking because of latest elasticsearch
1.4.0
-----
- Add support for Google Analytics tracking
- Add backend support for search.
1.3.1
-----
- Ensure localisation is fastforwarded
1.3.0
-----
- Add localisation support to schema
1.2.2
-----
- Change order of get_image_url params
1.2.1
-----
- Use `image_host` from json
1.2.0
-----
- Add image support to view
1.1.1
-----
- Use custom locale negotiator
1.1.0
-----
- Added image field to model
- Add fallback for Swahili and English UK
1.0.13
-----
- Use not_analyzed for language field
1.0.12
-----
- Ensure `get_page` returns None instead of 404
1.0.11
-----
- Ensure sensible default for ordering pages (default: position)
1.0.10
-----
- Ensure featured pages in category on homepage are ordered by position (ascending)
1.0.9
-----
- Ensure featured pages in category on homepage are ordered by position
1.0.8
-----
- Autodeployment with travis - attempt 2
1.0.7
-----
- Autodeployment with travis - attempt 1
1.0.6
-----
- Enforce ordering for pages and categories using `position`
1.0.5
-----
- Added date formatting helper
0.6.3
-----
- Redirect to homepage after changing language
0.6.2
-----
- Better wrapper around repos & workspaces to make moving away from
pygit2 easier.
0.6.1
-----
- Fix for workspace caching
0.6.0
-----
- Cache workspace to reduce number of open files
0.5.0
-----
- Views now return actual objects instead of dictionaries
to the template contexts.
0.4.3
-----
- Fixed bug when filtering multiple language pages by slug
0.4.2
-----
- Pages now render markdown
0.4.1
-----
- Change default cache duration to 10mins
0.4.0
-----
- Allow content to be featured on homepage
0.3.2
-----
- Ensure setting locale always redirects
0.3.1
-----
- Fix error when checking language for cached category/page
0.3.0
-----
- Allow content to be filtered by language selection
0.2.8
-----
- Add support for flat pages
0.2.7
-----
- Add caching to `get_featured_category_pages`
0.2.6
-----
- Added sensible default for available_languages
0.2.5
-----
- Added support for translations
0.2.4
-----
- Allow top nav to be global variable
0.2.2
-----
- Use `utils.get_workspace()` to avoid duplication
0.2.2
-----
- Fix development.ini file
0.2.1
-----
- Bump required version for praekelt-python-gitmodel
0.2
---
- Added `git.content_repo_url` for cloning when app starts
0.1
---
- Initial version
===========================
.. code-block:: bash
$ virtualenv ve
$ source ve/bin/activate
(ve)$ pip install -e .
Running Unicore CMS for local development
-----------------------------------------
This is a Pyramid_ application, that uses Elasticsearch and Redis.
For OS X we recommend you install Elasticsearch and Redis with Brew_:
.. code-block:: bash
$ brew install elasticsearch
$ brew install redis
Start Elasticsearch in a separate Terminal tab:
.. code-block:: bash
$ elasticsearch
Start Redis in a separate Terminal tab:
.. code-block:: bash
$ redis-server
For Linux install them with your package manager (apt, rpm, yum etc...)
and make sure it's running as a service.
Then start the server:
.. code-block:: bash
(ve)$ pserve development.ini --reload
It'll run happily with the stock ``development.ini`` file provided but
it will be without any content.
For a better experience, load a content repository:
.. code-block:: bash
(ve)$ git clone https://github.com/universalcore/unicore-cms-content-ffl-tanzania repo
(ve)$ eg-tools resync -c development.ini -m unicore.content.models.Category -f mappings/category.mapping.json -r true
(ve)$ eg-tools resync -c development.ini -m unicore.content.models.Page -f mappings/page.mapping.json
(ve)$ eg-tools resync -c development.ini -m unicore.content.models.Localisation -f mappings/localisation.mapping.json
Running Unicore CMS tests
-------------------------
.. code-block:: bash
(ve)$ pip install -r requirements-dev.txt
(ve)$ py.test cms
.. _Pyramid: http://docs.pylonsproject.org/en/latest/docs/pyramid.html
.. _Brew: http://brew.sh
CHANGELOG
=========
1.10.1
------
- Add endpoint for retreiving repo names
1.10.0
------
- Add marathon version info to health check
1.9.8
-----
- Fix parsing of result_per_page configuration option (it's passed in as a
string and needed to be parsed into an integer).
1.9.7
-----
- Fix bug that prevented the results_per_page configuration option
from having an effect on the number of pages displayed in a
category listing.
1.9.6
-----
- Add pagination to category listings
1.9.5
-----
- use latest version of elastic-git (pins elasticsearch==1.7.0)
1.9.4
-----
- Exclude health checks from GA analytics
1.9.3
-----
- Add uswgi to dependencies
1.9.0
-----
- Support remote repos via unicore.distribute.
- Remove auto-cloning of repo on startup.
1.8.1
-----
- Add fallbacks for unsupported languages
- Ensure GA Titles are specified for static pages
1.8.0
-----
- Add comments using unicore.comments.client
- Handle non-existent category in page and category views
- Add page/category title context to GA
1.7.1
-----
- pin cornice to 1.0.0
1.7.0
-----
- Add auth using unicore.hub.client
- pin cornice to 0.18.1
1.6.6
-----
- Remove cornice version pinning
1.6.5
-----
- Consistently convert ES objects to `elastic-git` model objects
1.6.4
-----
- Add localised logo support
1.6.3
-----
- Ensure detail page doesn't break for flat pages
1.6.2
-----
- Use latest changes of EG (Changes to Avro schema)
1.6.1
-----
- provide es host in fastforward
1.6.0
-----
- Add branded 404 page
- Allow reading of `es.host` from config
1.5.2
-----
- Refactor Search templates
1.5.1
-----
- Ensure list of languages in change page is sorted
1.5.0
-----
- Change language selector to allow featured languages
1.4.2
-----
- Allow querystring-less locale url
1.4.1
-----
- Fix tests breaking because of latest elasticsearch
1.4.0
-----
- Add support for Google Analytics tracking
- Add backend support for search.
1.3.1
-----
- Ensure localisation is fastforwarded
1.3.0
-----
- Add localisation support to schema
1.2.2
-----
- Change order of get_image_url params
1.2.1
-----
- Use `image_host` from json
1.2.0
-----
- Add image support to view
1.1.1
-----
- Use custom locale negotiator
1.1.0
-----
- Added image field to model
- Add fallback for Swahili and English UK
1.0.13
-----
- Use not_analyzed for language field
1.0.12
-----
- Ensure `get_page` returns None instead of 404
1.0.11
-----
- Ensure sensible default for ordering pages (default: position)
1.0.10
-----
- Ensure featured pages in category on homepage are ordered by position (ascending)
1.0.9
-----
- Ensure featured pages in category on homepage are ordered by position
1.0.8
-----
- Autodeployment with travis - attempt 2
1.0.7
-----
- Autodeployment with travis - attempt 1
1.0.6
-----
- Enforce ordering for pages and categories using `position`
1.0.5
-----
- Added date formatting helper
0.6.3
-----
- Redirect to homepage after changing language
0.6.2
-----
- Better wrapper around repos & workspaces to make moving away from
pygit2 easier.
0.6.1
-----
- Fix for workspace caching
0.6.0
-----
- Cache workspace to reduce number of open files
0.5.0
-----
- Views now return actual objects instead of dictionaries
to the template contexts.
0.4.3
-----
- Fixed bug when filtering multiple language pages by slug
0.4.2
-----
- Pages now render markdown
0.4.1
-----
- Change default cache duration to 10mins
0.4.0
-----
- Allow content to be featured on homepage
0.3.2
-----
- Ensure setting locale always redirects
0.3.1
-----
- Fix error when checking language for cached category/page
0.3.0
-----
- Allow content to be filtered by language selection
0.2.8
-----
- Add support for flat pages
0.2.7
-----
- Add caching to `get_featured_category_pages`
0.2.6
-----
- Added sensible default for available_languages
0.2.5
-----
- Added support for translations
0.2.4
-----
- Allow top nav to be global variable
0.2.2
-----
- Use `utils.get_workspace()` to avoid duplication
0.2.2
-----
- Fix development.ini file
0.2.1
-----
- Bump required version for praekelt-python-gitmodel
0.2
---
- Added `git.content_repo_url` for cloning when app starts
0.1
---
- Initial version
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
unicore-cms-1.10.1.tar.gz
(195.0 kB
view details)
File details
Details for the file unicore-cms-1.10.1.tar.gz.
File metadata
- Download URL: unicore-cms-1.10.1.tar.gz
- Upload date:
- Size: 195.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b1a8e0aa9f7a108814dd8c447e17a70d6d9ec724b75dc524f90deec1e277f222 |
|
| MD5 | 7016d17cb18263a286e44d4bd038e70a |
|
| BLAKE2b-256 | 57c64c5a6aa0d3604c2f9f30c4f22b46baed5caf3a37e00f923dffa4de7bca44 |
