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 `, 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 `. 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 @@ ++ ++ ++ ++ Academy lectures ++ academy.lectures ++ ++ ++ ++ ++ ++ ++ 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