Commit Graph

147 Commits

Author SHA1 Message Date
Odoo
0023788209 [IMP] howto/accounting: fiscal position refs
closes odoo/documentation#13019

Related: odoo/odoo#205191
Related: odoo/enterprise#83056
Related: odoo/upgrade#7528
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2025-04-24 18:17:10 +00:00
Carlos Valverde
82e3806c26 [IMP] howto/website/theming: improves version information
This commit improves current Odoo version information on the theming
page, by adding better contextual content.

Task-4316619

closes odoo/documentation#12974

X-original-commit: 543a18f82a
Signed-off-by: Carlos Valverde (cvs) <cvs@odoo.com>
2025-04-19 08:02:34 +00:00
Carlos Valverde
2afce92f07 [FW][FIX] howto/website: fix theming page typo
This PR fixes a typo on current theming page.

Task-4316611

closes odoo/documentation#12800

Forward-port-of: odoo/documentation#12778
Signed-off-by: Carlos Valverde (cvs) <cvs@odoo.com>
2025-04-04 15:09:11 +00:00
Carlos Valverde
8aa2c35096 [IMP] howto/website: update animations page
This commit updates current animations page, by adding updated content.

Task-4316707

closes odoo/documentation#12761

X-original-commit: 3e03ff41fa
Signed-off-by: Carlos Valverde (cvs) <cvs@odoo.com>
2025-04-02 15:58:46 +00:00
Carlos Valverde
0b95fb2200 [IMP] howto/website: update theming page
This commit updates current theming page, by adding updated content.

Task-4316707

closes odoo/documentation#12760

X-original-commit: 167ba9c2e1
Signed-off-by: Carlos Valverde (cvs) <cvs@odoo.com>
2025-04-02 15:58:45 +00:00
Carlos Valverde
47deeebc23 [IMP] howto/website: update media page
This commit updates current media page, by adding updated content.

Task-4316619

closes odoo/documentation#12750

X-original-commit: 533a6fde70
Signed-off-by: Carlos Valverde (cvs) <cvs@odoo.com>
2025-04-02 10:59:18 +00:00
Brandon Mercier
c595327929 [IMP] howto/website_themes: "Pages" page update
- Update Bootstrap documentation urls
- Update Github urls
- Update Odoo version number into the manifest example
- Dynamic Odoo version number in the code-block of the manifest example.
- Typos

closes odoo/documentation#12742

X-original-commit: ab9717eab0
Signed-off-by: Brandon Mercier (bram) <bram@odoo.com>
2025-04-01 18:15:46 +00:00
Brandon Mercier
510510d8e6 [IMP] howto/website_themes: Building blocks page update
- Change the Github urls to the correct version of Odoo
- Adapt the way of creating a snippet template and how to add it to the builder
- Add explanation about how to make a custom snippet "inner content"

closes odoo/documentation#12743

X-original-commit: eb0a61a4cf
Signed-off-by: Brandon Mercier (bram) <bram@odoo.com>
2025-04-01 18:15:45 +00:00
Brandon Mercier
865e6b5d7e [IMP] howto/website_themes: Layout page update
- Update the Bootstrap documentation urls
- Update the Github urls

closes odoo/documentation#12730

X-original-commit: a602f01f21
Signed-off-by: Brandon Mercier (bram) <bram@odoo.com>
2025-04-01 13:35:27 +00:00
Julien Castiaux
d4e13fc634 [IMP] developer,*: Demo data no longer loaded by default
Community: https://github.com/odoo/odoo/pull/194585

task-4317765

closes odoo/documentation#12680

Signed-off-by: Julien Castiaux (juc) <juc@odoo.com>
2025-03-31 14:04:58 +00:00
Carlos Valverde
7287e378fc [IMP] howto/website: update theming page
This commit updates current theming page, by adding updated content.

Task-4316619

closes odoo/documentation#12673

X-original-commit: adac5615c3
Signed-off-by: Carlos Valverde (cvs) <cvs@odoo.com>
2025-03-31 12:14:18 +00:00
Carlos Valverde
3d16e8bdd8 [IMP] howto/website: update navigation page
This commit updates current navigation page, by adding updated
information.

Task-4316619

closes odoo/documentation#12642

X-original-commit: 299cc648b8
Signed-off-by: Carlos Valverde (cvs) <cvs@odoo.com>
2025-03-27 09:07:28 +00:00
Brandon Mercier
f7738a48b1 [IMP] website_themes: layout
Add explanation about the `template_header_mobile`

closes odoo/documentation#12634

X-original-commit: 8c6fb203be
Signed-off-by: Brandon Mercier (bram) <bram@odoo.com>
2025-03-25 11:25:25 +00:00
Brandon Mercier
3c602e7dbe [IMP/ADD] website_themes: "Pages" page update
- New static page template mechanism;
- Replace the header_overlay screenshot
- Update the noattribute for 17.0

closes odoo/documentation#12633

X-original-commit: e99d444827
Signed-off-by: Brandon Mercier (bram) <bram@odoo.com>
2025-03-25 11:25:23 +00:00
Brandon Mercier
9bffe3b6d7 [IMP/ADD] website_themes: Building blocks page update
- Add "Text highlights"
- Add "grid-item-padding" and "grid-gap"
- Add Inner content snippet process

closes odoo/documentation#12623

X-original-commit: 6b73fe9f5a
Signed-off-by: Brandon Mercier (bram) <bram@odoo.com>
2025-03-25 09:38:22 +00:00
Josse Colpaert
6761aa3cab [IMP] localizationsdev: adapt link to fiscal position file
closes odoo/documentation#12616

X-original-commit: ea373280e1
Related: odoo/odoo#203163
Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
Signed-off-by: Josse Colpaert (jco) <jco@odoo.com>
2025-03-24 20:00:36 +00:00
Brandon Mercier
f99c6d02a2 [IMP] Website Themes - Building blocks
Rework of the whole page in order to organized / categorized the content better + Addition from the PSBE Designers Wiki

[FIX] Website Themes - Building block : Fix typo

[FIX] Corrections after review

X-original-commit: 062b4c8004

[FIX] Resolve conflicts

closes odoo/documentation#12524

X-original-commit: b3e773438a
Signed-off-by: Brandon Mercier (bram) <bram@odoo.com>
2025-03-17 04:29:33 +00:00
Brandon Mercier
b2f15201ba [IMP] Website Themes - Going Live
[IMP] Website Themes - Going Live

- Content update and additions
- Screenshot
- New anchors

[FIX] Fix after code review

[FIX] Anchor to noupdate attribute

closes odoo/documentation#12519

X-original-commit: 664d73771c
Signed-off-by: Brandon Mercier (bram) <bram@odoo.com>
2025-03-16 21:10:08 +00:00
Brandon Mercier
684b062fa3 [IMP] Website themes - Pages
[IMP] Website themes - Pages
[FIX] Website Themes - Pages: Anchors
[FIX] Website Themes - Pages: anchors
[FIX] Anchors patterns + code review modifications

closes odoo/documentation#12514

X-original-commit: f046604336
Signed-off-by: Brandon Mercier (bram) <bram@odoo.com>
2025-03-16 11:31:46 +00:00
Brandon Mercier
6737cf2975 [IMP] Website Themes - Layout page
[IMP] Website Themes - Layout page

[FIX] Corrections for ci

[FIX] Ci failure

[IMP] Small corrections

- Reorder the Xpath examples.
- Add an explanation for the move directive

[ADD] Website Themes - Media section

[IMP] Website Themes - Layout section modifications

[IMP] Anchors for CEDE's references (Tutorials)

[IMP] Line width + visibility conditions alert type

[IMP] Website Themes - Layout : Anchors correction

Revert "[ADD] Website Themes - Media section"

This reverts commit 4567cfe114251cdc9f263b8e97f0f988945f4db8.

[FIX] Update anchors pattern

[FIX] Media company logo reference

closes odoo/documentation#12508

X-original-commit: 4d4d75b440
Signed-off-by: Brandon Mercier (bram) <bram@odoo.com>
2025-03-15 17:26:22 +00:00
Carlos Valverde
dab554454f [ADD] howto/website: add media page
This commit adds the `media` page, links it to the `website_themes`
index, deletes duplicated content from the `pages.rst` page and moves
images from the current `pages` folder to a new one.

Task-4316611

closes odoo/documentation#12470

X-original-commit: 0044a6bb09
Signed-off-by: Carlos Valverde (cvs) <cvs@odoo.com>
2025-03-14 17:15:22 +00:00
Brandon Mercier
1f31c7d595 [IMP] Website Themes - Gradients
[IMP] Website Themes - Gradients

- Corrections
- New anchors

[FIX] Modifications after code review

closes odoo/documentation#12455

X-original-commit: dab8e3c71e
Signed-off-by: Brandon Mercier (bram) <bram@odoo.com>
2025-03-14 17:15:07 +00:00
Brandon Mercier
a2fc9b4f19 [IMP] Website Themes - Forms
[IMP] Website Themes - Forms
[FIX] Anchors + Modifications after code review

closes odoo/documentation#12459

X-original-commit: 88301e22ea
Signed-off-by: Brandon Mercier (bram) <bram@odoo.com>
2025-03-14 17:15:06 +00:00
Sam Degueldre
07603cc177 [FIX] frontend owl components: fix typo in code example
closes odoo/documentation#12408

X-original-commit: aaff61fd7d
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Samuel Degueldre (sad) <sad@odoo.com>
2025-03-14 15:38:03 +00:00
Carlos Valverde
fbe20b4754 [IMP] howto/website: update shapes page
This commit updates current `shapes` page, by adding new anchor links
to the sections, updated information and images.

Task-4316611

closes odoo/documentation#12458

X-original-commit: 4e0f298786
Signed-off-by: Carlos Valverde (cvs) <cvs@odoo.com>
2025-03-14 15:37:52 +00:00
Carlos Valverde
db51564ffc [IMP] howto/website: update navigation page
This commit updates current navigation page, by adding new anchor links
to the sections and by adding updated information.

Task-4316611

closes odoo/documentation#12456

X-original-commit: a548d85da8
Signed-off-by: Carlos Valverde (cvs) <cvs@odoo.com>
2025-03-14 15:37:51 +00:00
Carlos Valverde
db29f26230 [IMP] howto/website: update animations page
This commit updates current `animations` page, by adding new anchor
links to the sections, updated information and images.

Task-4316611

closes odoo/documentation#12457

X-original-commit: 0ea5823a94
Signed-off-by: Carlos Valverde (cvs) <cvs@odoo.com>
2025-03-14 15:37:50 +00:00
Brandon Mercier
22211c33b5 [IMP] Website Themes - Setup
[IMP] Website Themes - Setup

[IMP] Website Themes - Setup

- Use the right code-block language for terminal command line
- Add a step about the 2-factor authentication

[IMP] Anchors for CEDE's references (Tutorials)

[FIX] Website Themes - Setup: Anchors

[IMP] Anchors pattern correction

closes odoo/documentation#12428

X-original-commit: 9d5ccb7e1d
Signed-off-by: Brandon Mercier (bram) <bram@odoo.com>
2025-03-14 12:18:48 +00:00
Carlos Valverde
61bc20f514 [IMP] howto/website: update translations page
This commit updates current `translations` page, by adding new anchor
links to the sections, updated information and images.

Task-431661

closes odoo/documentation#12349

X-original-commit: e508d96c1d
Signed-off-by: Carlos Valverde (cvs) <cvs@odoo.com>
2025-03-11 11:57:53 +00:00
Carlos Valverde
65531a9297 [IMP] howto/website: update theming page
This commit updates current theming page, by adding new anchor links to
the sections and by adding updated information.

Task-4316611

closes odoo/documentation#12285

X-original-commit: 16e1bad7db
Signed-off-by: Carlos Valverde (cvs) <cvs@odoo.com>
2025-03-10 12:55:46 +00:00
Julien Castiaux
f9d7e3d693 [IMP] core: make author field mandatory in manifests
External contributors (and namely Odoo PS) forget to set the author
field in their manifest file. The result is that the module is wrongly
registered with `'author': 'Odoo S.A.'`.

This work makes the field mandatory, with a warning when not set. It
also offers an upgrade-code script to mass-rewrite all the manifests in
order to set the author.

task-4485983

closes odoo/documentation#11956

Related: odoo/odoo#196408
Related: odoo/enterprise#78513
Related: odoo/design-themes#1044
Signed-off-by: Julien Castiaux (juc) <juc@odoo.com>
2025-02-24 10:35:06 +00:00
samueljlieber
194ed8085a [FIX] clean unused resource files
X-original-commit: a4b841afce
Part-of: odoo/documentation#12082
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Samuel Lieber (sali) <sali@odoo.com>
2025-02-14 21:59:10 +00:00
Erwin Zoer
41f15664e2 [FW][FIX] developer/howtos/upgrade_custom_db: fix typo
Changed the word devolopments to developments

closes odoo/documentation#11886

Forward-port-of: odoo/documentation#11864
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2025-01-28 02:59:49 +00:00
Bastien Fafchamps (bafa)
b21777ddae [FW][IMP] developer/*: update js code to ES6
This PR updates javascript code to be up to date with the codebase standards:
- use the `static` keyword when possible
- proper owl imports
- removed unecessary `@odoo-module` directives

Task ID: 2258359

closes odoo/documentation#11483

Forward-port-of: odoo/documentation#11466
Signed-off-by: Bastien Fafchamps (bafa) <bafa@odoo.com>
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2024-12-11 12:35:20 +00:00
Krzysztof Magusiak
6395455f0b [IMP] core: SQLObject replaces _sql_constraints
task-3390431

closes odoo/documentation#11071

Related: odoo/odoo#175783
Related: odoo/enterprise#68589
Signed-off-by: Krzysztof Magusiak (krma) <krma@odoo.com>
2024-11-08 07:33:30 +00:00
Gorash
f1a607a9c7 [IMP] *: Using class name corresponding to odoo models
closes odoo/documentation#11115

Related: odoo/odoo#178200
Related: odoo/enterprise#69762
Related: odoo/upgrade#6577
Related: odoo/design-themes#988
Related: odoo/upgrade-util#143
Signed-off-by: Christophe Matthieu (chm) <chm@odoo.com>
2024-10-15 09:33:04 +00:00
Krzysztof Magusiak (krma)
c6208a51ef [IMP] core: Environment._ for translations
odoo/odoo#174844

closes odoo/documentation#10421

Related: odoo/enterprise#67528
Signed-off-by: Krzysztof Magusiak (krma) <krma@odoo.com>
2024-09-15 15:44:18 +00:00
xpl-odoo
669a62c625 [IMP] upgrade: better introduce the upgrade process
closes odoo/documentation#10919

X-original-commit: e05a37917d
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2024-09-04 10:01:59 +00:00
Enmanuel Otero Montano
f9f855cd2e [FW][FIX] howtos/javascript_view: fix typo
A typo was found. The word "customeKanbanView" is misspelled and should be "customKanbanView", which is the constant exported correctly in the code. Therefore, the corrected line would be:

closes odoo/documentation#9676

Forward-port-of: odoo/documentation#9661
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2024-06-06 16:27:19 +00:00
Alvaro Fuentes
3bba491f57 [IMP] doc: improve organization of upgrades docs
* Add autodoc directives to generate documentation directly from
  upgrade-util repo.
* Group all upgrades-related reference documentation into one group in
  the sidebar, instead of having two entries.
* Mention `upgrades` vs `migrations` directory. It has been supported
  since a while but nothing was explicit in the documentation.

Original commit: 91a48bfe88

closes odoo/documentation#8849

X-original-commit: ef4b5f87d5
Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
2024-04-19 13:35:52 +00:00
Antoine Vandevenne (anv)
57b7ca69d9 [IMP] developer: improve navigation in top-level pages
Prior to this commit, users had to either know in advance or guess the
location of the content they were looking for. Top-level pages of the
"Developer" section of the documentation, in particular the "Developer"
page itself, were listing their sub-pages without directions for users.

This commit brings the following changes to improve the navigation:
- add directions for users on the "Developer" page and list the three
  main categories of developer documentation ("Tutorials", "How-to
  guides", and "Reference") with explanations of their content and
  target audience;
- add categories for content cards on the "Tutorials" and "How-to
  guides" pages, and fine-tune the toctree of the "Reference" page to
  more easily locate specific topics;
- clarify what are the "Python framework" and the "JavaScript framework"
  by relabelling them to "Server framework" and "Web framework" on
  top-level pages, as some users were confused to find that the JS
  framework was not responsible for the server, and others that the
  documentation for QWeb template is located in the Python documentation;
- extract the "Setup guide" from the "Getting started" tutorial and
  rename the latter to "Server framework 101" to allow reusing the setup
  guide in other tutorials and make clear that the "Server framework 101"
  tutorial is not about the Web framework.

task-3802536

closes odoo/documentation#8712

X-original-commit: 7f623b6ad5
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Co-authored-by: Valeriya (vchu) <vchu@odoo.com>
2024-04-13 12:16:35 +00:00
Samuel Degueldre
ff36e1f7aa [IMP] web: create how-to for using Owl components in the frontend
closes odoo/documentation#8149

X-original-commit: e259853486
Signed-off-by: Samuel Degueldre (sad) <sad@odoo.com>
2024-03-15 15:59:20 +00:00
Jonathan Castillo (jcs)
0249d9d0a6 [MOV] documentation structure reorganization
This commit aims to improve the documentation's navigability by
redefining some categories' purposes and titles.

There is a redirection rule for each documentation page moved.
This ensures that users won't have a 404 error message.

task-3217827

closes odoo/documentation#8064

Signed-off-by: Jonathan Castillo (jcs) <jcs@odoo.com>
2024-03-12 07:08:34 +00:00
Rémy Voet (ryv)
99751542c7 [IMP] orm: renaming of group_operator -> aggregator
closes odoo/documentation#5541

Related: odoo/enterprise#46795
Related: odoo/odoo#127353
Signed-off-by: Rémy Voet (ryv) <ryv@odoo.com>
2024-02-08 11:24:50 +00:00
Michaël Mattiello
973d5800d2 [IMP] web: update javascript odoo modules
This commit adapts the javascript modules section with the last
update https://github.com/odoo/odoo/pull/142858 and some outdated
features.

closes odoo/documentation#7640

Signed-off-by: Michaël Mattiello (mcm) <mcm@odoo.com>
2024-02-06 15:53:40 +00:00
Augusto Perez
1febb15453 [ADD] Upgrade documentation: Upgrade scripts and Util package
closes odoo/documentation#7550

X-original-commit: 16a209c750
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2024-01-26 09:56:30 +00:00
Antoine Vandevenne (anv)
14c0438764 [IMP] reference/user_interface: reformat and clarify views reference
In particular, the following changes are made:
- Use the `class` and `attribute` admonitions along with custom
  attributes to define classes, views' root attributes, views'
  components, and attribute values. This allows re-using the responsive
  design that was made for reference lists, and getting rid of the
  previous implementation that relied on class attributes, which were not
  intended for this usage and reduce readability while hindering further
  contributions due to a lack of flexibility (no admonitions,
  sub-attributes...)
- Use definition lists to define view types to allow for clearer and
  longer descriptions.
- Rewrite and restructure the explanations when there is a lack clarity.
- Extract duplicated content to included RST files.
- Display SVG images into dedicated admonitions.
- Fix RST and English mistakes.
- Rename `view_architecture` to `view_architectures`, as it lists all
  existing architectures and doesn't describe "the architecture of a
  view".
- Replace underscores with hyphens in image file names to improve SEO.

task-3458320

closes odoo/documentation#5237

closes odoo/documentation#7497

X-original-commit: a17eaf4c6f
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2024-01-23 10:51:24 +00:00
Nathan Marotte (nama)
080dc64e54 [ADD] Upgrade documentation: How-to-guide for developers
closes odoo/documentation#7336

X-original-commit: 44f4683519
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2024-01-11 17:21:54 +00:00
Géry Debongnie
045fb847e8 [IMP] Rework the JavaScript tutorials
This commit rework the entire JavaScript tutorial series with the
following improvements:

-   Each chapter is now designed to be independent, allowing learners to
    follow any chapter without the necessity of completing previous ones.
-   Each chapter has been transformed into a standalone module, enabling
    learners to create small projects from scratch within each chapter.
-   The screenshots/text/code have been updated for Odoo 17.

Currently we have 5 chapters:
- Discover Chapter 1 - Owl Components: This chapter allows to learn the
  Owl framework in the `awesome_owl` module.
- Discover Chapter 2 - Build a dashboard: This chapter allows to grasp
  the basic of the web framework by building a dashboard in the
  `awesome_dashboard` module.
- Master Chapter 1 - Build a clicker game: This chapter allows to grasp
  the web framework by building a clicker game in the `awesome_clicker`
  module.
- Master Chapter 2 - Create a gallery view: This chapter allows to learn
  how to create a new view type. The new view is a gallery of records
  pictures. It can be done in the `awesome_gallery` module.
- Master Chapter 3 - Customize a kanban view: This chapter allows to
  learn to customize a kanban view by implementing a list of customer in
  the side of a kanban view. This can be done in the `awesome_kanban`
  module.

The chapter on creating and customizing fields is deleted for now and
will be completely rewritten in a near future.
The chapter on testing is deleted, how-to guides will be written to
cover this subject.

The solutions for all exercises has been done for v17, the goal by
merging the new tutorial is to have this new branch structure in
`odoo/tutorials`:
- 16.0
- 16.0-solutions
- 17.0
- 17.0-discover-js-framework-solutions
- 17.0-master-odoo-web-framework-solutions
-   master <-- default branch, starting point for all addons
-   master-discover-js-framework-solutions
-   master-master-odoo-web-framework-solutions

closes odoo/documentation#6980

Task-id: 3623595
X-original-commit: 3d4a275196
Signed-off-by: Géry Debongnie <ged@odoo.com>
Signed-off-by: Florent Dardenne (dafl) <dafl@odoo.com>
2023-12-20 00:41:24 +00:00
Samuel Degueldre
b093bdc871 [FIX] developer: remove confusing section about starting services
When writing the documentation page for standalone Owl apps, it was
originally required to create the env and start the services manually,
and then mount the application by giving it a bunch of configuration
parameters. During review, it was noted that this was error prone and
confusing, and as such a corresponding PR added a helper to mount the
application without needing to do much by hand. While the code was
adapted in the documentation that was merged, the text still referred to
starting the services and creating the environment which is no longer
necessary.

This commit removes references to those things, and because the
resulting section is very small and not very interesting it has been
merged into the previous section.

closes odoo/documentation#6692

X-original-commit: 8e3008f06a
Signed-off-by: Samuel Degueldre (sad) <sad@odoo.com>
2023-11-28 05:50:46 +00:00