Skip to content

Commit

Permalink
bootstrap repo: add README, website_cms and website_cms_search
Browse files Browse the repository at this point in the history
  • Loading branch information
simahawk committed Oct 3, 2016
0 parents commit afa50c5
Show file tree
Hide file tree
Showing 68 changed files with 5,892 additions and 0 deletions.
20 changes: 20 additions & 0 deletions README.md
@@ -0,0 +1,20 @@
[![Runbot Status](https://runbot.odoo-community.org/runbot/badge/flat/186/9.0.svg)](https://runbot.odoo-community.org/runbot/repo/github-com-oca-website-186)
[![Build Status](https://travis-ci.org/OCA/website-cms.svg?branch=9.0)](https://travis-ci.org/OCA/website-cms)
[![Coverage Status](https://coveralls.io/repos/OCA/website-cms/badge.png?branch=9.0)](https://coveralls.io/r/OCA/website-cms?branch=9.0)

Odoo modules for website CMS
============================

Includes modules that add advanced CMS functionalities to Odoo and include:

* TODO

[//]: # (addons)
Available addons
----------------
addon | version | summary
--- | --- | ---
[website_cms](website_cms/) | 9.0.1.0.2 | Adds real CMS features to your Odoo website
[website_cms_search](website_cms_search/) | 9.0.1.0.0 | Adds full text search to website CMS

[//]: # (end addons)
5 changes: 5 additions & 0 deletions website_cms/.gitignore
@@ -0,0 +1,5 @@
.DS_Store
*.pyc
*.pyo
*.~*
*.~
1 change: 1 addition & 0 deletions website_cms/AUTHORS
@@ -0,0 +1 @@
* Simone Orsi at Camptocamp
8 changes: 8 additions & 0 deletions website_cms/CHANGES.rst
@@ -0,0 +1,8 @@
CHANGELOG
=========

9.0.1.0.1 (Unreleased)
----------------------

* 1st release

113 changes: 113 additions & 0 deletions website_cms/README.rst
@@ -0,0 +1,113 @@
.. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
:alt: License

Website CMS
===========

This is a module that adds real CMS features to your Odoo website.

Documentation: TODO

Premise
-------

Odoo has no real "Content Management System" features.
You cannot manage contents, since - beside blogs and blogposts - you don't have any real "web content".
You can design nice pages on the fly using the website builder - which is indeed a powerful and awesome feature -
but that's not the only thing a CMS should be able to do.

Yes, you have "pages" but right now an Odoo page is just a template
with some specific characteristics (flags, and so on) plus a fixed route "/page".
So, every page's URL in the website will be something like "/page/my-nice-article-about-something".
The same goes for blogs and blogposts: you will always have URLs like "/blog/my-nice-blog-1/posts/my-interesting-post-1".

With this limitations you cannot organize contents (a page, an attachment, etc) in sections and sub sections,
hence you cannot build a hierarchy that will allow to expose contents in a meaningful way, for you and your visitors.

The goal of this module is to provide base capabilities for creating and managing web contents.

Note that this module does not provide a whole theme,
but gives you the right tools to create yours.
So you should build your own theme to expose your content, navigation, etc.


Main features
-------------

* Separation of concerns between ``page`` (content) and ``view`` (presentation)

A page is the content you publish and you can assign a view to it.
A view is just an Odoo template that present your content.

* Page types

We define 2 basic types: `Simple` and `News`. You can add more
and list, present, search pages in different ways based on types.

* Reusable views

Create your own views according to your website design and reuse them when needed.

* Publish media and categorize it

A ``media`` could be everything: an image, a video, a link to an image or a video.
You can categorize it rely on auto-categorization based on mimetypes.
Preview images are loaded automatically but you can customize them.

* Automatic navigation and site hierarchy

A page can contain other pages, acting like a folder. By nesting pages you create a hierarchy.
This can be used to show global and contextual navigation without having to
customize menu links every now and then.

* Meaningful URLs

Pages' URLs are built using their hierarchy.
For instance, if you have a section `cars` that contains a sub section `sport`
that contains a page 'Porche' the final URL will be `/cms/cars/sport/porche`.

* Manage redirects within page backend

You can force a page to redirect to another page or to an external link,
and you can choose which kind of redirect status code to use (301, 302, etc)

* Protect your content

On each page you can decide who can view it (edit permission yet to come).
This happens at page level not view's, so that you can have different pages
presented with same view but with different permissions.

* Full text search

The extra module ``website_cms_search`` adds features for doing full text searches.


Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/CMS/issues>`_.
In case of trouble, please check there if your issue has already been reported.


Credits
=======

Contributors
------------

Read the `contributors list`_

.. _contributors list: ./AUTHORS

Maintainer
----------

.. image:: http://odoo-community.org/logo.png
:alt: Odoo Community Association
:target: http://odoo-community.org

This module is maintained by the OCA.

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

To contribute to this module, please visit http://odoo-community.org.
3 changes: 3 additions & 0 deletions website_cms/ROADMAP.rst
@@ -0,0 +1,3 @@
/// add missing from docs and talk

* listing: if not published you do not see YOUR un-published content
6 changes: 6 additions & 0 deletions website_cms/__init__.py
@@ -0,0 +1,6 @@
# -*- coding: utf-8 -*-
# © <YEAR(S)> <AUTHOR(S)>
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).

from . import models
from . import controllers
45 changes: 45 additions & 0 deletions website_cms/__openerp__.py
@@ -0,0 +1,45 @@
# -*- coding: utf-8 -*-
# © <YEAR(S)> <AUTHOR(S)>
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
{
"name": "Website CMS",
"summary": "CMS features",
"version": "1.0.2",
"category": "Website",
"website": "https://odoo-community.org/",
"author": "Simone Orsi - Camptocamp, Odoo Community Association (OCA)",
"license": "AGPL-3",
"installable": True,
'application': False,
"depends": [
"base",
'website',
],
"data": [
# security
'security/groups.xml',
'security/ir.model.access.csv',
# data
"data/page_types.xml",
"data/media_categories.xml",
# "data/form_settings.xml",
# views
"views/menuitems.xml",
"views/cms_page.xml",
"views/cms_redirect.xml",
"views/cms_media.xml",
"views/cms_media_category.xml",
'views/website_menu.xml',
# templates
"templates/assets.xml",
"templates/misc.xml",
"templates/layout.xml",
"templates/menu.xml",
"templates/page.xml",
"templates/sidebar.xml",
"templates/form.xml",
],
'external_dependencies': {
'python': ['requests', ],
},
}
2 changes: 2 additions & 0 deletions website_cms/controllers/__init__.py
@@ -0,0 +1,2 @@
from . import main
from . import form

0 comments on commit afa50c5

Please sign in to comment.