@ -1,11 +1,30 @@
.. image :: https://img.shields.io/badge/licence-AGPL--3-blue.svg
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
:alt: License: AGPL-3
====================
====================
Improved Name Search
Improved Name Search
====================
====================
.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |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%2Fserver--tools-lightgray.png?logo=github
:target: https://github.com/OCA/server-tools/tree/11.0/base_name_search_improved
:alt: OCA/server-tools
.. |badge4| image :: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/server-tools-11-0/server-tools-11-0-base_name_search_improved
:alt: Translate me on Weblate
.. |badge5| image :: https://img.shields.io/badge/runbot-Try%20me-875A7B.png
:target: https://runbot.odoo-community.org/runbot/149/11.0
:alt: Try me on Runbot
|badge1| |badge2| |badge3| |badge4| |badge5|
Extends the name search feature to use additional, more relaxed
Extends the name search feature to use additional, more relaxed
matching methods, and to allow searching into configurable additional
matching methods, and to allow searching into configurable additional
record fields.
record fields.
@ -19,12 +38,12 @@ so "John M. Brown" would be a match.
It also tolerates words in a different order, so searching
It also tolerates words in a different order, so searching
for "brown john" also works.
for "brown john" also works.
.. ima ge :: images/image0.png
.. f igur e:: https://raw.githubusercontent.com/OCA/server-tools/11.0/base_name_search_improved/ images/image0.png
Additionally, an Administrator can configure other fields to also lookup into.
Additionally, an Administrator can configure other fields to also lookup into.
For example, Customers could be additionally searched by City or Phone number.
For example, Customers could be additionally searched by City or Phone number.
.. ima ge :: images/image2.png
.. f igur e:: https://raw.githubusercontent.com/OCA/server-tools/11.0/base_name_search_improved/ images/image2.png
How it works:
How it works:
@ -42,12 +61,10 @@ The specific methods used are:
All results found are presented in that order,
All results found are presented in that order,
hopefully presenting them in order of relevance.
hopefully presenting them in order of relevance.
**Table of contents**
Installation
============
No specific requirements.
.. contents ::
:local:
Configuration
Configuration
=============
=============
@ -59,22 +76,15 @@ The regular ``search()``, used in the top right search box, is not affected.
Additional search fields can be configured at Settings > Technical > Database > Models,
Additional search fields can be configured at Settings > Technical > Database > Models,
using the "Name Search Fields" field.
using the "Name Search Fields" field.
.. image :: images/image1.png
.. figure :: https://raw.githubusercontent.com/OCA/server-tools/11.0/base_name_search_improved/images/image1.png
:alt: Name Search Fields
:width: 600 px
Usage
Usage
=====
=====
Just type into any related field, such as Customer on a Sale Order.
Just type into any related field, such as Customer on a Sale Order.
.. image :: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
:alt: Try me on Runbot
:target: https://runbot.odoo-community.org/runbot/149/9.0
.. repo_id is available in https://github.com/OCA/maintainer-tools/blob/master/tools/repos_with_ids.txt
.. branch is "8.0" for example
Known issues / Roadmap
Known issues / Roadmap
======================
======================
@ -83,39 +93,49 @@ Known issues / Roadmap
* The list of additional fields to search could benefit from caching, for efficiency.
* The list of additional fields to search could benefit from caching, for efficiency.
* This feature could also be implemented for regular `` search `` on the `` name `` field.
* This feature could also be implemented for regular `` search `` on the `` name `` field.
Bug Tracker
Bug Tracker
===========
===========
Bugs are tracked on `GitHub Issues
<https://github.com/OCA/server-tools/issues> `_. In case of trouble, please
check there if your issue has already been reported. If you spotted it first,
help us smashing it by providing a detailed and welcomed feedback.
Bugs are tracked on `GitHub Issues <https://github.com/OCA/server-tools/issues> `_ .
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us smashing it by providing a detailed and welcomed
`feedback <https://github.com/OCA/server-tools/issues/new?body=module:%20base_name_search_improved%0Aversion:%2011.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
Credits
=======
=======
Image s
------
Author s
~~~~~~~
* Odoo Community Association: `Icon <https://github.com/OCA/maintainer-tools/blob/master/template/module/static/description/icon.svg> `_ .
* Daniel Reis
Contributors
Contributors
------------
~~~~~~~~~~~~
* Daniel Reis <https://github.com/dreispt>
* Daniel Reis <https://github.com/dreispt>
Maintainer
----------
Other credits
~~~~~~~~~~~~~
The development of this module has been financially supported by:
* Odoo Community Association
Maintainers
~~~~~~~~~~~
This module is maintained by the OCA.
.. image :: https://odoo-community.org/logo.png
.. image :: https://odoo-community.org/logo.png
:alt: Odoo Community Association
:alt: Odoo Community Association
:target: https://odoo-community.org
:target: https://odoo-community.org
This module is maintained by the OCA.
OCA, or the Odoo Community Association, is a nonprofit organization whose
OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
mission is to support the collaborative development of Odoo features and
promote its widespread use.
promote its widespread use.
To contribute to this module, please visit https://odoo-community.org.
This module is part of the `OCA/server-tools <https://github.com/OCA/server-tools/tree/11.0/base_name_search_improved> `_ project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.