官术网_书友最值得收藏!

Installing addon modules from GitHub

GitHub is a great source of third-party addons. A lot of Odoo partners use GitHub to share the addons they maintain internally, and the Odoo Community Association (OCA) collectively maintains several hundreds of addons on GitHub. Before starting to write your own addon, be sure to check that nothing already exists that you could use as is or as a starting point.

This recipe will show you how to clone the partner-contact project of the OCA from GitHub and make the addon modules it contains available in your instance.

Getting ready

Suppose you want to change the way addresses are handled in your instance; your customer needs a third field in addition to Odoo's two (street and street2) to store addresses. You could certainly write your own addon to add a field on res.partner, but the issue is a bit trickier than it seems if you want the address to be properly formatted on invoices. Fortunately, someone on a mailing list tells you about the partner_address_street3 addon that is maintained by the OCA as part of the partner-contact project.

The paths used in this recipe reflect the layout proposed in the Standardizing your instance directory layout recipe.

How to do it…

To install partner_address_street3, follow these steps:

  1. Go to your project's directory:
    $ cd ~/odoo-dev/my-odoo
    
  2. Clone the 9.0 branch of the partner-contact project in the src/ directory:
    $ git clone --branch 9.0 \
    https://github.com/OCA/partner-contact.git src/partner-contact
    
  3. Change the addons path to include that directory and update the addons list of your instance (see previous recipes, Configure the addons path and Update the addon modules list, of this chapter).
  4. Install the partner_address_street3 addon (see the previous previous recipe, Install and upgrade local addon modules).

How it works…

All the Odoo Community Association code repositories have their addons contained in separate subdirectories, which is coherent with what is expected by Odoo regarding the directories in the addons path; therefore, just cloning the repository somewhere and adding that location in the addons path is enough.

There's more…

Some maintainers follow a different approach and have one addon module per repository, living at the root of the repository. In that case, you need to create a new directory, which you will add to the addons path and clone all the addons from that maintainer you need in this directory. Remember to update the addon modules list each time you add a new repository clone.

主站蜘蛛池模板: 阳新县| 汉沽区| 沅陵县| 潍坊市| 印江| 南康市| 南宫市| 邹平县| 阳朔县| 谢通门县| 淮阳县| 开阳县| 策勒县| 句容市| 颍上县| 武陟县| 峡江县| 乐昌市| 田阳县| 普格县| 临沧市| 浠水县| 乐昌市| 郯城县| 龙岩市| 龙泉市| 呼和浩特市| 大余县| 二连浩特市| 黄浦区| 辽中县| 蕲春县| 曲沃县| 张家界市| 井陉县| 万宁市| 黔东| 广丰县| 营山县| 涞源县| 仁寿县|