Commit Graph

295 Commits

Author SHA1 Message Date
Claire Bretton (clbr)
620508fb29 [FIX] getting_started: remove useless lambda
The lambda function here is useless and makes newdooers think
they need to use it everytime.
`default=fields.Date.add(fields.Date.today(), months=3))`
should do the trick, no lambda involved.

closes 

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-11-23 13:07:05 +00:00
Claire Bretton (clbr)
8707609b38 [FIX] getting_started: invalid addons-path
The "../technical-training-sandbox" is added too early in the path since
its still empty, and results into an "invalid addons-path" error.

Part-of: 
2023-11-23 13:07:05 +00:00
Rémy Voet (ryv)
f1960a250c [IMP] orm: update changelog
closes 

Signed-off-by: Rémy Voet (ryv) <ryv@odoo.com>
2023-11-15 10:40:22 +00:00
Louis Baudoux
282f041ed1 [IMP] iap: remove documentation related to IAP services creation
It has been decided to remove the possibility for our users to create
their own IAP services.
This decision was motivated by the fact that, in the 5 years of
existence of IAP, very few non-Odoo services have been created and
actively used by our customers.

X-original-commit: 0c1b7c4636
Part-of: 
2023-11-07 16:10:04 +00:00
Louis Baudoux
9df648b4c7 [IMP] extract_api: document the new API version
We have introduced a second version of the Extract API that adds the IAP
account token to the `get_result` and `validate` routes.

There are also other changes in this commit:
 - The deprecated stuff has been removed as it's been deprecated for a
   while and won't be supported anymore in the future.
 - The `status` table of the `get_result` route has been added as it was
   missing for some reason.
 - The documentation regarding the `/validate` routes have been removed
   for security reasons.

closes 

X-original-commit: a8c6272899
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Louis Baudoux (lba) <lba@odoo.com>
2023-11-03 11:50:00 +00:00
Rémy Voet (ryv)
378252afdf [FIX] developer: fix bad documentation of --unaccent
In the CLI, `--unaccent` try to enable PostgreSQL unaccent extention
when odoo is responsible to create new database(s).

closes 

X-original-commit: 1639d22efd
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Rémy Voet (ryv) <ryv@odoo.com>
2023-10-31 07:00:57 +00:00
Mathieu Duckerts-Antoine
7a936c9f70 [FIX] search panel: fix bad indentation
closes 

X-original-commit: 82055c1f15
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Mathieu Duckerts-Antoine (dam) <dam@odoo.com>
2023-10-23 14:19:03 +00:00
Stan (stgu)
6f3ed657fc [IMP] howtos/translations: text & tips
Remove parenthesis around a term that's fairly straightforward to
understand and later used as a title Add a much-needed point.

closes 

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-10-13 17:01:06 +00:00
Denis Ledoux
3b56832297 [FIX] qweb: type "overrinding"
overrinding -> overriding

closes 

X-original-commit: d141144be5
Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
2023-10-06 16:43:28 +00:00
Louis Baudoux
cade61dd56 [FIX] extract_api: remove bill_reference from expense fields
The bill reference is no longer detected since a few months because it
had poor results and wasn't very useful.

closes 

Signed-off-by: Louis Baudoux (lba) <lba@odoo.com>
2023-10-05 11:24:20 +00:00
Louis Baudoux
24c7b2506e [REM] extract_api: remove documentation of get_result_batch
For security reasons, we had to drop the support of those routes.

Part-of: 
2023-10-05 11:24:20 +00:00
dispread
407534595a [FIX] developer/tutorials: wrong kanban view example
Pretty sure the previous wasnt the intended result as it would show the "this is new" in a new kanban card. This just groups it with the property it belongs to.

closes 

Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
2023-09-25 09:03:54 +00:00
Leloup Loïc (lole)
12f3b1beb7 [IMP] cli: add unit to memory options
The documentation is unclear about the unit used for the --limit-memory-soft
and --limit-memory-hard options of odoo-bin.  The unit used is bytes, but
it isn't mentioned and the default unit is shown in mebibytes, causing
confusion.

closes 

X-original-commit: 9fadc3355d
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-09-11 08:16:46 +00:00
fdardenne
c1c04f90a8 [IMP] Views howtos: add details on how to use a view in arch
closes 

Signed-off-by: Florent Dardenne (dafl) <dafl@odoo.com>
2023-09-08 11:22:35 +00:00
Odoo's Mergebot
d8e71d6063 [FIX] developer/tutorials/discover_js_framework: fix broken "domain.js" link
The link pointing to domain.js file was broken.
The xml id on the line before that is also broken but it will be fixed with PR#5699.

closes 

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Co-authored-by: Armin FalDiS <armin.fallah96@gmail.com>
Co-authored-by: Armin FalDiS <fara@odoo.com>
2023-09-01 16:10:49 +00:00
Andrea Tasselli
44ef78b391 [FIX] developer/tutorials/discover_js_framework: add missing this
closes 

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-08-30 12:03:28 +00:00
Xavier (XPL)
32b92f5959 [FIX] install: fix reference and redirect
closes 

X-original-commit: f1db43b3ac
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-08-19 00:14:55 +02:00
Xavier (XPL)
da2a48b9fd [REF] install: move intro to main install page and split by install type
This PR moves the introduction about the different installation methods and editions found on the
install/install.rst page directly under the main install/ page. It creates three pages, one per
installation method documented on the install/install.rst page (Docker being documented on
docker.com and maintained by us), and moves the related content there. In addition, it fixes various
typos/grammar issues and improves the content according to the documentation guidelines. Various
references and links across the documentation had to be fixed accordingly.

task-3459070

closes 

X-original-commit: 42a8f492e7
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-08-18 09:50:42 +02:00
Antoine Vandevenne (anv)
bb04b18e7f [FIX] tutorials/getting_started: fix typos in example model name
Commit f36c612d13 changed the model name
in Chapter 4 without updating the other occurences.

closes 

X-original-commit: b6f923d111
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-08-17 19:13:24 +02:00
imanie383
56eed9771e [FIX] reference/owl_components: fix typo
Making edits for Owl Components Doc : [Link](https://www.odoo.com/documentation/16.0/developer/reference/frontend/owl_components.html#example-multi-level-dropdown-nested)

![image](https://github.com/odoo/documentation/assets/35231827/b2dd4b87-941c-4241-b0f5-e91ca69b3633)

closes 

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-08-11 14:43:56 +02:00
Levi Siuzdak (sile)
a7743d513b [IMP] developer: add notes on entity references & fix illegal XML
Using `<` inside XML elements will result in a parsing error,
an entity reference should be used instead: `&lt;`.

closes 

Signed-off-by: Levi Siuzdak (sile) <sile@odoo.com>
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-07-24 14:37:53 +02:00
chyde-clearwater
bd434b0528 [IMP] tutorials/getting_started: disambiguate example model name
I removed the dot notation in the  "_name" variable for the example
model. AKA, "test.model" is now named "test_model".

Dot notation implies a data structure relationship between a <model> and
it's parent (or class etc) <test> (like test.model() or Test.model).
There is no relationship like this between a <test> and <model> - it's
just one thing: a <test model>.

The seeming "benefit" of the ORM translating dots to underscores doesn't
justify this naming convention.  Yes, I know it's a string, but still,
this seems confusing for newbies and adds unnecessary complexity (why
name the same thing differently in different places?)

closes 

X-original-commit: f36c612d13
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-07-18 12:53:34 +02:00
Henrique Dias
0a65b0872d [ADD] rpc: Go examples
Examples rely on `kolo/xmlrpc` as well as on the standard library package `log` to panic on error, matching snippets in other languages (which tend to raise exceptions).

As with other languages, only the RPC interaction is spelled out.

closes 

Signed-off-by: Xavier Morel (xmo) <xmo@odoo.com>
2023-07-14 10:11:48 +02:00
Marc Durepos
c85031b3fc [FIX] Remove reference to assets_qweb in assets.rst
Reflects the fact that assets_qweb bundle is no longer used in 16.0

closes 

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-07-13 10:40:51 +02:00
Benoit Socias
1c98265c95 [FIX] howto/rdtraining: ch.13 adapt reference to salesperson field
In chapter 13 the `property_ids` field is defined as the inverse of a
`user_id` field. But in chapter 8 when the salesperson field is added,
no such name is given to it.

This commit adapts the description to reference the general concept of
the field used to link to the salesperson instead of an actual field
identifier.

task-3381757

closes 

X-original-commit: 3a131c829a
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-06-27 16:07:02 +02:00
Benoit Socias
77fe26c390 [IMP] developer/views: add optional attribute for fields of list views
The attributes of fields of list views do not mention the `optional`
attribute while it is used by chapter 12 of the R&D Training.

This commit describes this `optional` attribute.

task-3380953

closes 

X-original-commit: 5a446f5c59
Signed-off-by: Benoit Socias (bso) <bso@odoo.com>
2023-06-27 16:07:00 +02:00
Christophe Monniez
eb6c567ee2 [FIX] deploy: reference the config parameter
The deploy documentation is assuming that `/etc/odoo.conf` is the
default config file, which is not the case.

With this commit, the configuration file references the cli
documentation.

closes 

X-original-commit: 8aed7988ba
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Christophe Monniez (moc) <moc@odoo.com>
2023-06-20 15:42:14 +02:00
Jonathan Castillo (jcs)
ebeebbcd45 [MOV] accounting: restructuration of the accounting documentation
This commit improves the structure of the accounting documentation by
- reducing the levels necessary to reach the information
- grouping some docs
- moving content to their parent category page (content in all levels)
- renaming some sections to reflect the structure of the app better

task-3330093

closes 

Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-05-20 08:26:00 +02:00
CVDE-odoo
892fd3e2ac [ADD] developer/howto: guide for theming
A complete guide on how to create a custom website theme for Odoo

closes 

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-05-11 20:37:08 +02:00
Antoine Vandevenne (anv)
26e12696c1 [IMP] tutorials/getting_started: rework the environment setup guide
This commit replaces a big chunk of the instructions relative to the
environment setup with a reference to the equivalent steps listed in the
contribution guide. It also moves the content of the "Create your first
PR" section from chapter 16 to chapter 2, as readers were struggling
with the Git configuration required to push their work to GitHub as they
progressed through the tutorial.

closes 

X-original-commit: 276f981703
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-05-11 11:29:46 +02:00
Antoine Vandevenne (anv)
c1b38dc1f3 [FIX] reference/services: mark optional the params parameter of rpc
closes 

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-04-27 11:30:29 +02:00
Antoine Vandevenne (anv)
b58dbb1fbb [IMP] tutorials/js_framework: reword, clarify and improve instructions
Part-of: 
2023-04-27 11:30:29 +02:00
Antoine Vandevenne (anv)
6e746c851f [IMP] tutorials/js_framework: freeze GitHub links with line numbers
A few links were already outdated. Either the referenced code was no
longer on the same line, or the file didn't exist anymore.

This commit freezes all links targeting a specific line on the odoo/odoo
repository by selecting a specific commit.

Part-of: 
2023-04-27 11:30:29 +02:00
Antoine Vandevenne (anv)
ce14b2cfb5 [IMP] tutorials/js_framework: retarget links to the current major branch
Commits pushed on the odoo/tutorials repository are not automatically
forward-ported, which makes it cumbersome to keep all SaaS branches up
to date.

Because of this, and because Odoo developers are very unlikely to follow
tutorials specific to a SaaS branch, links to odoo/tutorials now target
the current major branch, or master if applicable. SaaS branches have
also been deleted from the odoo/tutorials repository.

Part-of: 
2023-04-27 11:30:28 +02:00
Géry Debongnie
b6b9de70d2 [IMP] developer/tutorials: separate js framework tutorial in two parts
This commit splits the 7 chapters of the JS tutorial in two
smaller and more focused tutorials:
- a basic one (Discover the JS framework)
- and an advanced one (Master the odoo web framework)

closes 

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-04-24 19:01:01 +02:00
Artygo8
07eef81a95 [IMP] reference/extract: update documentation
task-3071317

closes 

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-04-21 14:15:46 +02:00
Mahmoud Metwally
9e6f4a8c56 [FW][FIX] howtos/company: fix typos
closes 

Forward-port-of: 
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-04-17 17:48:23 +02:00
Mahmoud Metwally
32c6bed34b [FW][FIX] developer/web_services: fix typo
closes 

Forward-port-of: 
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-04-14 12:47:22 +02:00
Tiffany Chang (tic)
7124542ed9 [REF] developer: rewrite sql view as a howto
SQL view was formerly part of the dashboard tutorial which is now
obsolete. Since creating a SQL view as a tutorial does not make sense
anymore, it has been converted into a simple howto.

closes 

Task: 3226581
Signed-off-by: Tiffany Chang <tic@odoo.com>
2023-04-05 14:47:46 +02:00
Tiffany Chang (tic)
e2c880aafe [REM] developer: remove references to web_dashboard view
Since  the dashboard view no longer exists since it
is now replaced with spreadsheet_dashboard, therefore we remove it from
the backend Views documentation.

Task: 3226581
Part-of: 
2023-04-05 14:47:46 +02:00
fdardenne
7e4435deb8 [IMP] create JavaScript howtos
The JavaScript cheatsheet is outdated, we therefore remove it and
replace it by multiple howtos:

- Create a view from scratch
- Extending an existing view
- Create a field from scratch
- Extend an existing field
- Create a client action

There is other subjects to introduce as the web framework is big. Other
future contributions will cover them.

closes 

Signed-off-by: Dardenne Florent (dafl) <dafl@odoo.com>
2023-04-04 16:06:19 +02:00
Benoit Socias
ee8341402a [IMP] tutorials: add warning about mutable global variables
The whole concept of multi-tenancy is not really approached within the
tutorial.

This commit adds a warning about never using mutable global variables
within odoo to seed the idea in the reader's mind.

task-3059110

closes 

X-original-commit: 1ce7166f49
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Benoit Socias (bso) <bso@odoo.com>
2023-04-03 15:42:15 +02:00
Jonathan Castillo (jcs)
6866cfa361 [FIX] dev/tuto: grammar mistake in 02_setup
task-3238089

closes 

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-03-20 12:29:04 +01:00
Antoine Vandevenne (anv)
34bc63d2bc [ADD] extensions/cards: add an extension to implement cards
The extension adds two new directive:
- `cards` is the row container for one or more `card` directives.
- `card` is the implementation of a Bootstrap card that accepts a
  `target` argument for the href of the card, a `large` option to render
  the card on two columns, a `tag` option to display a single arbitrary
  tag on the card, and arbitrary content that is shown in the card
  body.

task-3141419

closes 

X-original-commit: 72e636da5f
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-02-28 10:55:05 +01:00
Antoine Vandevenne (anv)
3dc6bb83c1 [MOV] developer/cli: move "Command-line interface (CLI)" to the reference dir
task-2991663

closes 

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-02-23 14:33:17 +01:00
Antoine Vandevenne (anv)
73f976e679 [MOV] developer/api/extract_api: move "Extract API" to the reference dir
task-2991663

Part-of: 
2023-02-23 14:33:17 +01:00
Antoine Vandevenne (anv)
95ed856446 [MOV] developer/api/external_api: move "External API" to the reference dir
task-2991663

Part-of: 
2023-02-23 14:33:17 +01:00
Antoine Vandevenne (anv)
b817e16a4c [MOV] developer/api/iap: move "In-App Purchase" to the howtos dir
task-2991663

Part-of: 
2023-02-23 14:33:16 +01:00
Antoine Vandevenne (anv)
2701d91db0 [MOV] developer/iot: move "Internet of things" the howtos dir
task-2991663

Part-of: 
2023-02-23 14:33:16 +01:00
Antoine Vandevenne (anv)
9561c9abf8 [IMP] tutorials/*: hide outdated tutorials
*: backend, web, website

task-2991663

Part-of: 
2023-02-23 14:33:16 +01:00