Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
140 changes: 140 additions & 0 deletions website_mobile_button/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,140 @@
=====================
Website Mobile Button
=====================

..
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:9478d256408e47bdf4e58b0835ef2bd2d3cb41f0c5b0a963e4c12ef04602444d
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
:target: https://odoo-community.org/page/development-status
:alt: Beta
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
:alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fwebsite-lightgray.png?logo=github
:target: https://github.com/OCA/website/tree/18.0/website_mobile_button
:alt: OCA/website
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/website-18-0/website-18-0-website_mobile_button
:alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
:target: https://runboat.odoo-community.org/builds?repo=OCA/website&target_branch=18.0
:alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module adds a fixed navigation bar at the bottom of the website on
mobile devices, similar to the tab bar of a mobile app.

Features:

- The bar can be enabled or disabled for each website from the website
editor.
- Buttons are fully editable with the website editor: icon or logo,
label, link, colors and size.
- Each button is a building block that can be dragged into the bar,
duplicated, reordered or removed.
- The whole button area is clickable, not only its text.
- Separators between buttons, background color and shadow of the bar are
configurable.
- The content is stored per website, so each website can have a
different bar.
- The bar is only displayed on small screens (below the ``lg`` Bootstrap
breakpoint).

**Table of contents**

.. contents::
:local:

Usage
=====

To enable the bottom bar on a website:

1. Go to the website you want to configure and click **Edit**.
2. Open the **Customize** tab.
3. Enable the **Mobile Bottom Bar** option.

The bar is hidden on large screens, but it is always displayed while
editing so it can be configured from a desktop. Use the mobile preview
of the editor to see how it will look on a phone.

To edit a button:

1. Click on the icon, or double-click it to replace it with another icon
or with an image (logo).
2. Click on the label to change the text.
3. Click on the button outside the icon and the text (its padding area)
to select the whole button. In the options panel you can set:

- **Link (URL)** and **Open in new tab**.
- **Background** and **Text / icon color**.
- **Label**: show or hide the text.
- **Icon size**.

Do not use the editor link tool on the label: the link is set from the
button options, which makes the whole button clickable.

To add, duplicate, move or remove buttons:

1. Drag the **Bottom Bar Button** block from the blocks panel into the
bar, or use the duplicate and delete icons on a selected button.
2. Drag buttons to change their order.

To configure the whole bar, click on the bar outside any button. The
options panel allows to change:

- **Background** color.
- **Shadow**: none, small or medium.
- **Separators** between buttons: line, short line or none.

Changes are saved per website. In a multi-website database, repeat the
configuration on each website.

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

Bugs are tracked on `GitHub Issues <https://github.com/OCA/website/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/website/issues/new?body=module:%20website_mobile_button%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
-------

* Dixmit

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

- `Dixmit <https://www.dixmit.com>`__

- Enric Tobella

Maintainers
-----------

This module is maintained by the OCA.

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

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.

This module is part of the `OCA/website <https://github.com/OCA/website/tree/18.0/website_mobile_button>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
Empty file.
19 changes: 19 additions & 0 deletions website_mobile_button/__manifest__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Copyright 2026 Dixmit
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).

{
"name": "Website Mobile Button",
"summary": """Add a mobile button box for easier configuration""",
"version": "18.0.1.0.0",
"license": "AGPL-3",
"author": "Dixmit,Odoo Community Association (OCA)",
"website": "https://github.com/OCA/website",
"depends": ["website"],
"data": ["views/templates.xml"],
"assets": {
"web.assets_frontend": [
"website_mobile_button/static/src/scss/*.scss",
],
},
"demo": [],
}
3 changes: 3 additions & 0 deletions website_mobile_button/pyproject.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
[build-system]
requires = ["whool"]
build-backend = "whool.buildapi"
2 changes: 2 additions & 0 deletions website_mobile_button/readme/CONTRIBUTORS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
- [Dixmit](https://www.dixmit.com)
- Enric Tobella
11 changes: 11 additions & 0 deletions website_mobile_button/readme/DESCRIPTION.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
This module adds a fixed navigation bar at the bottom of the website on mobile devices, similar to the tab bar of a mobile app.

Features:

- The bar can be enabled or disabled for each website from the website editor.
- Buttons are fully editable with the website editor: icon or logo, label, link, colors and size.
- Each button is a building block that can be dragged into the bar, duplicated, reordered or removed.
- The whole button area is clickable, not only its text.
- Separators between buttons, background color and shadow of the bar are configurable.
- The content is stored per website, so each website can have a different bar.
- The bar is only displayed on small screens (below the `lg` Bootstrap breakpoint).
40 changes: 40 additions & 0 deletions website_mobile_button/readme/USAGE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
To enable the bottom bar on a website:

1. Go to the website you want to configure and click **Edit**.
2. Open the **Customize** tab.
3. Enable the **Mobile Bottom Bar** option.

The bar is hidden on large screens, but it is always displayed while
editing so it can be configured from a desktop. Use the mobile preview
of the editor to see how it will look on a phone.

To edit a button:

1. Click on the icon, or double-click it to replace it with another icon
or with an image (logo).
2. Click on the label to change the text.
3. Click on the button outside the icon and the text (its padding area)
to select the whole button. In the options panel you can set:
- **Link (URL)** and **Open in new tab**.
- **Background** and **Text / icon color**.
- **Label**: show or hide the text.
- **Icon size**.

Do not use the editor link tool on the label: the link is set from the
button options, which makes the whole button clickable.

To add, duplicate, move or remove buttons:

1. Drag the **Bottom Bar Button** block from the blocks panel into the
bar, or use the duplicate and delete icons on a selected button.
2. Drag buttons to change their order.

To configure the whole bar, click on the bar outside any button. The
options panel allows to change:

- **Background** color.
- **Shadow**: none, small or medium.
- **Separators** between buttons: line, short line or none.

Changes are saved per website. In a multi-website database, repeat the
configuration on each website.
Binary file added website_mobile_button/static/description/icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading