Skip to content

Commit

Permalink
Merge commit 'refs/pull/179/head' of https://github.com/OCA/connector…
Browse files Browse the repository at this point in the history
…-prestashop into 15.0
  • Loading branch information
docker-odoo committed May 15, 2024
2 parents 7f227ad + 1a05f7d commit 036340f
Show file tree
Hide file tree
Showing 169 changed files with 53,162 additions and 0 deletions.
205 changes: 205 additions & 0 deletions connector_prestashop/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,205 @@
=========================
PrestaShop-Odoo connector
=========================

..
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:d55da052f17578b24462cb1021eff586a11e452868fad86cfeb82fb891b692b4
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |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%2Fconnector--prestashop-lightgray.png?logo=github
:target: https://github.com/OCA/connector-prestashop/tree/15.0/connector_prestashop
:alt: OCA/connector-prestashop
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/connector-prestashop-15-0/connector-prestashop-15-0-connector_prestashop
: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/connector-prestashop&target_branch=15.0
:alt: Try me on Runboat

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

This module connects Odoo and PrestaShop.

PrestaShop (http://www.prestashop.com/) is a popular e-commerce platform
written in PHP/MySQL and published under the Open Software licence v3.0.

This module allows the synchronization of the following objects from PrestaShop
to Odoo:

* Websites
* Stores and languages
* Carriers
* Product categories
* Products
* Combinations of products
* Partner categories
* Customers

Once these objects are synchronised, it will allow the import of sales orders,
together with the related customers.

As an extra feature, you can also export the stock quantities back to
PrestaShop.

If you want to export from Odoo to PrestaShop changes made on the products,
product categories or product images, you need to install
*connector_prestashop_catalog_manager* module in this same repository.

This connector supports PrestaShop version up to 1.6.11. Maybe later versions
are also supported, but they haven't been tested. It uses the webservices of
PrestaShop.

**Table of contents**

.. contents::
:local:

Configuration
=============

To configure this module, you need to set several things in both PrestaShop
and Odoo:

Steps in PrestaShop
===================

#. Go to the control panel (usually at <url>/adminps).
#. Login into the system.
#. Go to *Advanced Parameters > Web service*
#. Add a new entry.
#. Generate a new API key that will be needed later.
#. Grant all the needed access according your security policy.

Steps in Odoo
=============

#. Go to *Connectors > PrestaShop > Backends*.
#. Create a new record for registering a PrestaShop backend. You will bind
this backend to an specific company and warehouse.
#. Define the main URL of the PrestaShop web, and the webservice key you
got in PrestaShop.
#. Define other parameters like the discount and shipping products, or if the
taxes are included in the price.
#. Click on "Synchronize Metadata" button. This will bring the basic shop
information that you can find on *Websites* and *Stores* menus.
#. Click on "Synchronize Base Data" button. This will import carriers,
languages, tax groups and the rest of base data that are needed for the
proper work.
#. Go to *Accounting > Configuration > Taxes > Tax Groups*, and include
for each of the tax definition imported from PrestaShop, the corresponding
taxes in Odoo.
#. Activate the job runner, checking the connector documentation for setting
the server correctly for using it in
http://odoo-connector.com/guides/jobrunner.html
#. Alternatively, if you are not able to activate it, you can enable the
scheduled job called "Enqueue Jobs".
#. Activate the scheduled jobs for importing the records you want:

* PrestaShop - Export Stock Quantities
* PrestaShop - Import Carriers
* PrestaShop - Import Customers and Groups
* PrestaShop - Import Products and Categories
* PrestaShop - Import Sales Orders
* PrestaShop - Import suppliers
* PrestaShop - Payment methods

Usage
=====

To use this module, you need to:

#. Go to *Connectors > Queue > Jobs*, and check the correct enqueuing of
the tasks.
#. Check on each menu the resulting imported records (Customers, Sales
Orders...)

Test dependencies
=================

Extra libs are required to run the tests:
* ``vcrpy``
* ``freezegun``

Known issues / Roadmap
======================

* Work with multiple warehouses.
* Tests.

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

Bugs are tracked on `GitHub Issues <https://github.com/OCA/connector-prestashop/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/connector-prestashop/issues/new?body=module:%20connector_prestashop%0Aversion:%2015.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
~~~~~~~

* Akretion
* Camptocamp
* AvanzOSC
* Tecnativa
* Mind And Go

Contributors
~~~~~~~~~~~~

* Sébastien Beau <[email protected]>
* Benoît Guillot <[email protected]>
* Alexis de Lattre <[email protected]>
* Guewen Baconnier <[email protected]>
* Sergio Teruel <[email protected]>
* Mikel Arregi <[email protected]>
* Pedro M. Baeza <[email protected]>
* Simone Orsi <[email protected]>
* Florent THOMAS <[email protected]>
* Francisco Fernández <[email protected]>
* Florian da Costa <[email protected]>
* Marc Poch <[email protected]>
* JesusVMayor <[email protected]>
* Hai Lang <[email protected]>

* `Greenice <https://www.greenice.com>`_:

* Fernando La Chica <[email protected]>

Other credits
~~~~~~~~~~~~~

* `PrestaShop logo <http://seeklogo.com/prestashop-logo-178788.html>`_.
* `Odoo logo <https://www.odoo.com/es_ES/page/brand-assets>`_.
* `Cable <https://openclipart.org/detail/174134/cable-with-connector>`_.

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/connector-prestashop <https://github.com/OCA/connector-prestashop/tree/15.0/connector_prestashop>`_ project on GitHub.

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

from . import connector

from . import components
from . import models
62 changes: 62 additions & 0 deletions connector_prestashop/__manifest__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
# Copyright 2011-2013 Camptocamp
# Copyright 2011-2013 Akretion
# Copyright 2015 AvanzOSC
# Copyright 2015-2016 Tecnativa
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).

{
"name": "PrestaShop-Odoo connector",
"version": "15.0.1.0.0",
"license": "AGPL-3",
"depends": [
"account",
"base_vat", # for vat validation on partner address
"product",
"product_multi_category", # oca/product-attribute
"product_multi_image", # oca/product-attribute
"connector_ecommerce", # oca/connector-ecommerce
"purchase",
"onchange_helper",
],
"external_dependencies": {
"python": [
"html2text",
"prestapyt",
# tests dependencies
"freezegun",
"vcrpy",
"bs4",
],
},
"author": "Akretion,"
"Camptocamp,"
"AvanzOSC,"
"Tecnativa,"
"Mind And Go,"
"Odoo Community Association (OCA)",
"website": "https://github.com/OCA/connector-prestashop",
"category": "Connector",
"demo": [],
"data": [
"security/ir.model.access.csv",
"security/prestashop_security.xml",
"data/queue_job_data.xml",
"data/cron.xml",
"data/product_decimal_precision.xml",
"data/ecommerce_data.xml",
"views/prestashop_backend_view.xml",
"views/product_view.xml",
"views/product_category_view.xml",
"views/image_view.xml",
"views/delivery_view.xml",
"views/connector_prestashop_menu.xml",
"views/partner_view.xml",
"views/sale_view.xml",
"views/account_view.xml",
"views/stock_view.xml",
"views/queue_job_views.xml",
"demo/backend.xml",
],
"installable": True,
"application": True,
}
14 changes: 14 additions & 0 deletions connector_prestashop/components/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).

# ConnectorUnit needs to be registered
from . import core
from . import backend_adapter
from . import binder
from . import importer
from . import exporter
from . import listener
from . import mapper
from . import deleter
from . import auto_matching_importer
from . import exception
from . import version_key
Loading

0 comments on commit 036340f

Please sign in to comment.