summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/howto/howto_website.rst69
-rw-r--r--doc/howto/howto_website/data-to-demo23
-rw-r--r--doc/howto/howto_website/lectures-action-and-menus33
-rw-r--r--doc/howto/howto_website/series2
4 files changed, 122 insertions, 5 deletions
diff --git a/doc/howto/howto_website.rst b/doc/howto/howto_website.rst
index d9a84a30e42..cc1dba77995 100644
--- a/doc/howto/howto_website.rst
+++ b/doc/howto/howto_website.rst
@@ -137,6 +137,8 @@ generally makes it simpler for designers to edit the markup.
.. todo:: link to section about reusing/altering existing stuff, template
overriding
+.. _howto-website-support:
+
OpenERP's Website support
=========================
@@ -155,12 +157,12 @@ no content and just basic placeholders in the header and footer. Click on the
default), click :guilabel:`Log in`.
You're now in OpenERP "proper", the backend/administrative interface. We'll
-deal with it in :ref:`a latter section <howto-website-administration>`, for
-how click on the :menuselection:`Website` menu item, in the top-left of the
-browser between :menuselection:`Messaging` and :menuselection:`Settings`.
+deal with it in :ref:`a latter section <howto-website-administration>`. For
+now, click on the :menuselection:`Website` menu item in the top-left of the
+browser, between :menuselection:`Messaging` and :menuselection:`Settings`.
You're back to your website, but are now an administrator and thus have access
-to the advanced edition features of an OpenERP-build website. Let's quickly
+to the advanced edition features of an OpenERP-built website. Let's quickly
run through them.
Mobile Preview
@@ -447,7 +449,6 @@ an explicit format for `the weekday in short form
is a limitation of the current ``website`` but may be improved in
future releases.
-.. access & formatting
.. sending & storing comments (?)
.. _howto-website-administration:
@@ -455,6 +456,64 @@ an explicit format for `the weekday in short form
Administration and ERP Integration
==================================
+In practice, the data we've created so far using XML data files is usually
+stored as "demo data", used for testing and demonstrations of modules, and the
+actual user data is input via the OpenERP "backend", which we're going to try
+out now. First let's move our data set to demo data:
+
+.. patch::
+
+the difference is simply that new databases can be created either in "demo"
+mode or in "no demo" mode. In the former case, the database will be preloaded
+with any demo data configured in the installed module.
+
+.. todo:: need to create a new DB again?
+
+A brief and incomplete introduction to the OpenERP administration
+-----------------------------------------------------------------
+
+You've already seen it for a very short time in :ref:`howto-website-support`,
+you can go back to it using :menuselection:`Administrator --> Administration`
+if you're already logged-in (which you should be), or go through
+:menuselection:`Sign In` again if you are not.
+
+The conceptual structure of the OpenERP backend is simple:
+
+1. first are menus, menus are a tree (they can have sub-menus). To menus
+ without children is mapped…
+
+2. an action. Actions have various types, they can be links, reports (PDF),
+ code which the server should execute or window actions. Window actions
+ tell the client to display the OpenERP object according to certain views…
+
+3. a view has a type, the broad category to which it corresponds (tree, form,
+ graph, calendar, …) and its architecture which represents the way the
+ object is laid out inside the view.
+
+By default, when an OpenERP object is *defined* it is essentially invisible in
+the interface. To make it visible, it needs to be available through an action,
+which itself needs to be reachable somehow, usually a through a menu.
+
+Let us, then, create a menu and an action for our lectures:
+
+.. patch::
+
+.. todo:: reinstall module? update?
+
+If you reload the backend, you should see a new menu :menuselection:`Academy`
+at the top-left corner, before :menuselection:`Messaging`. In it is the
+submenus we defined via ``menuitem``, and within (the first submenu is
+selected by default) opens a list view of the lectures. To the right is a
+series of 2 buttons, which lets you toggle between the "list" view (overview
+of all records in the object) and the "form" view (view an manipulation of a
+single record). The :guilabel:`Create` button above the list lets you create
+new record, you can select records to delete them.
+
+There's one big issue to fix right now, the labeling of the column in the list
+and the fields in the form view, which are all currently :guilabel:`unknown`:
+
+.. FIXME:: fix labels
+
.. create menu, action
.. improve generated views
.. create list & form views for events
diff --git a/doc/howto/howto_website/data-to-demo b/doc/howto/howto_website/data-to-demo
new file mode 100644
index 00000000000..4c0797f0543
--- /dev/null
+++ b/doc/howto/howto_website/data-to-demo
@@ -0,0 +1,23 @@
+# HG changeset patch
+# Parent 2af29a429acda61e5e567997dad78a673e011796
+diff --git a/__openerp__.py b/__openerp__.py
+--- a/__openerp__.py
++++ b/__openerp__.py
+@@ -5,7 +5,9 @@
+ 'data': [
+ 'ir.model.access.csv',
+ 'views/templates.xml',
+- 'data/teaching_assistants.xml',
+- 'data/lectures.xml',
++ ],
++ 'demo': [
++ 'demo/teaching_assistants.xml',
++ 'demo/lectures.xml',
+ ]
+ }
+diff --git a/data/lectures.xml b/demo/lectures.xml
+rename from data/lectures.xml
+rename to demo/lectures.xml
+diff --git a/data/teaching_assistants.xml b/demo/teaching_assistants.xml
+rename from data/teaching_assistants.xml
+rename to demo/teaching_assistants.xml
diff --git a/doc/howto/howto_website/lectures-action-and-menus b/doc/howto/howto_website/lectures-action-and-menus
new file mode 100644
index 00000000000..2f851491c9a
--- /dev/null
+++ b/doc/howto/howto_website/lectures-action-and-menus
@@ -0,0 +1,33 @@
+# HG changeset patch
+# Parent 419f2476f7485ffc81eced5233f323c3bea76100
+diff --git a/__openerp__.py b/__openerp__.py
+--- a/__openerp__.py
++++ b/__openerp__.py
+@@ -5,6 +5,7 @@
+ 'data': [
+ 'ir.model.access.csv',
+ 'views/templates.xml',
++ 'data/views.xml',
+ ],
+ 'demo': [
+ 'demo/teaching_assistants.xml',
+diff --git a/data/views.xml b/data/views.xml
+new file mode 100644
+--- /dev/null
++++ b/data/views.xml
+@@ -0,0 +1,15 @@
++<openerp>
++ <data>
++ <record id="action_academy_lecture" model="ir.actions.act_window">
++ <field name="name">Academy lectures</field>
++ <field name="res_model">academy.lectures</field>
++ </record>
++
++ <menuitem sequence="0" id="menu_academy" name="Academy"/>
++ <menuitem id="menu_academy_content" parent="menu_academy"
++ name="Academy Content"/>
++ <menuitem id="menu_academy_content_lectures"
++ parent="menu_academy_content"
++ action="action_academy_lecture"/>
++ </data>
++</openerp>
diff --git a/doc/howto/howto_website/series b/doc/howto/howto_website/series
index 162e9df8bbe..e8b52f313a3 100644
--- a/doc/howto/howto_website/series
+++ b/doc/howto/howto_website/series
@@ -14,3 +14,5 @@ ta-t-field
ta-html-biography
ta-template-biography
lectures-model-add
+data-to-demo
+lectures-action-and-menus