101 lines
		
	
	
		
			3.2 KiB
		
	
	
	
		
			ReStructuredText
		
	
	
			
		
		
	
	
			101 lines
		
	
	
		
			3.2 KiB
		
	
	
	
		
			ReStructuredText
		
	
	
.. 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
 | 
						|
 | 
						|
=======================
 | 
						|
Partner second lastname
 | 
						|
=======================
 | 
						|
 | 
						|
This module was written to extend the functionality of ``partner_firstname`` to
 | 
						|
support having a second lastname for contact partners.
 | 
						|
 | 
						|
In some countries, it's important to have a Midname for contacts.
 | 
						|
 | 
						|
Contact partners will need to fill at least one of the name fields
 | 
						|
(*First name*, *First last name* or *Midname*).
 | 
						|
 | 
						|
Configuration
 | 
						|
=============
 | 
						|
 | 
						|
You can configure some common name patterns for the inverse function
 | 
						|
in Settings > Configuration > General settings:
 | 
						|
 | 
						|
* Lastname Midname Firstname: For example 'Anderson Lavarge Robert'
 | 
						|
* Lastname Midname, Firstname: For example 'Anderson Lavarge, Robert'
 | 
						|
* Firstname Lastname Midname: For example 'Robert Anderson Lavarge'
 | 
						|
 | 
						|
After applying the changes, you can recalculate all partners name clicking
 | 
						|
"Recalculate names" button. Note: This process could take so much time depending
 | 
						|
how many partners there are in database.
 | 
						|
 | 
						|
You can use *_get_inverse_name* method to get firstname, lastname and
 | 
						|
second lastname from a simple string and also *_get_computed_name* to get a
 | 
						|
name form the firstname, lastname and second lastname.
 | 
						|
These methods can be overridden to change the format specified above.
 | 
						|
 | 
						|
 | 
						|
Usage
 | 
						|
=====
 | 
						|
 | 
						|
To use this module, you need to:
 | 
						|
 | 
						|
* Edit any partner's form.
 | 
						|
* Make sure the partner is not a company.
 | 
						|
* Enter firstname and lastnames.
 | 
						|
 | 
						|
If you directly enter the full name instead of entering the other fields
 | 
						|
separately (maybe from other form), this module will try to guess the best
 | 
						|
match for your input and split it between firstname, lastname and second
 | 
						|
lastname using an inverse function.
 | 
						|
 | 
						|
If you can, always enter it manually please. Automatic guessing could fail for
 | 
						|
you easily in some corner cases.
 | 
						|
 | 
						|
.. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
 | 
						|
   :alt: Try me on Runbot
 | 
						|
   :target: https://runbot.odoo-community.org/runbot/134/11.0
 | 
						|
 | 
						|
 | 
						|
Known issues / Roadmap
 | 
						|
======================
 | 
						|
 | 
						|
Patterns for the inverse function are configurable only at system level. Maybe
 | 
						|
this configuration could depend on partner language, country or company,
 | 
						|
as discussed at `this OCA issue <https://github.com/OCA/partner-contact/issues/210>`_
 | 
						|
 | 
						|
 | 
						|
Bug Tracker
 | 
						|
===========
 | 
						|
 | 
						|
Bugs are tracked on `GitHub Issues
 | 
						|
<https://github.com/OCA/partner-contact/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 `here
 | 
						|
<https://github.com/OCA/partner-contact/issues/new>`_.
 | 
						|
 | 
						|
 | 
						|
Credits
 | 
						|
=======
 | 
						|
 | 
						|
Contributors
 | 
						|
------------
 | 
						|
 | 
						|
* Jairo Llopis <jairo.llopis@tecnativa.com>.
 | 
						|
* Antonio Espinosa.
 | 
						|
* Pedro M. Baeza <pedro.baeza@tecnativa.com>.
 | 
						|
 | 
						|
Maintainer
 | 
						|
----------
 | 
						|
 | 
						|
.. image:: https://odoo-community.org/logo.png
 | 
						|
   :alt: Odoo Community Association
 | 
						|
   :target: https://odoo-community.org
 | 
						|
 | 
						|
This module is maintained by the OCA.
 | 
						|
 | 
						|
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.
 | 
						|
 | 
						|
To contribute to this module, please visit https://odoo-community.org.
 |