Introduction

The Odoo Infinity App Store is a marketplace where Odoo ERP users can find and purchase modules to enhance their systems. Vendors list their modules on the app store, often hosting them on GitHub. This setup allows businesses to easily access and integrate new functionalities into their Odoo installations. The app store acts as a sales platform for vendors, enabling them to reach a wide audience of Odoo users and sell their products directly. Modules can be quickly fetched from the vendor's GitHub account and installed, making it simple to add new features to Odoo. This streamlines the process for both users and vendors, offering a convenient way to extend the capabilities of the Odoo ERP system.

Login and Registration

This section outlines the login and registration processes for both users and vendors of the Odoo Infinity App Store.

For Vendors

Vendors can directly log in to the Odoo Infinity App Store using their GitHub account. This streamlined process ensures a seamless integration between the vendor's GitHub repositories and the App Store.

Vendor Login Process:

  1. Navigate to the Odoo Infinity App Store vendor login page.
  2. Click on the "Login with GitHub" button.
  3. Vendor Login Page
  4. You will be redirected to GitHub's authorization page.
  5. GitHub Authorization Page
  6. Grant the necessary permissions to the Odoo Infinity App Store.
  7. Upon successful authorization, you will be redirected back to the App Store and logged in.
  8. Vendor Dashboard

Note: Ensure that your GitHub account has the necessary repositories set up for your Odoo modules before logging in.

For Users

Users need to register for an account before they can log in to the Odoo Infinity App Store. This process allows users to create a personal account for browsing, purchasing, and managing Odoo modules.

User Registration Process:

  1. Go to the Odoo Infinity App Store homepage.
  2. Click on the "Login" button
  3. User Registration Page
  4. Click on "Don't have an account?"
  5. Fill out the registration form with the following information:
    • Full Name
    • Email Address
    • Password (must meet security requirements)
    • Company Name (optional)
  6. User Registration Page
  7. Agree to the terms of service and privacy policy.
  8. Click "Sign up".

User Login Process:

  1. Navigate to the Odoo Infinity App Store login page.
  2. Enter your registered email address and password.
  3. User Login Page
  4. Click "Log In".
  5. If you've forgotten your password, use the "Reset Password" link to reset it.
  6. Password Reset Page

Security Note: We recommend using a strong, unique password for your Odoo Infinity App Store account and enabling two-factor authentication if available.

For any issues with login or registration, please contact our support team at [email protected].

Collaborating with GitHub Private Repositories

The Odoo Infinity App Store allows vendors to collaborate using their private GitHub repositories. This process ensures secure code management while enabling seamless integration with the App Store. Here's how to set up the collaboration:

Steps to Collaborate Your Private Repository with the App Store Admin

  1. Log into your GitHub account.
  2. Navigate to the repository you want to collaborate with the App Store.
  3. Click on the "Settings" tab in your repository.
  4. In the left sidebar, click on "Collaborators".
  5. GitHub will ask you to enter your password for security purposes. Enter your password.
  6. Once authenticated, you'll see a search bar. In this search bar, enter the App Store admin's GitHub username.
  7. Click on the admin's username when it appears in the search results.
  8. Click the "Add collaborator" button to send an invitation.
  9. Wait for approximately 10-15 minutes. During this time, the App Store admin will receive and accept the collaboration invitation.
GitHub Collaborators Interface 1 GitHub Collaborators Interface 2 GitHub Collaborators Interface 3 GitHub Collaborators Interface 4 GitHub Collaborators Interface 5 GitHub Collaborators Interface 6

Note: The App Store admin's GitHub username will be provided to you by the Odoo Infinity App Store team. If you don't have this information, please contact their support team.

Github Integration

The Odoo Infinity App Store features GitHub integration for app publisher, allowing them to manage and sell their modules seamlessly. app publisher must log in with their GitHub account and use their repository's SSH key to add modules to the app store. Before listing their modules, app publisher must collaborate with the App store team to ensure their modules meet quality and compatibility standards.

GitHub Integration Overview

This integration streamlines the process, making it easy for app publisher to manage updates and for users to access and install new functionalities.

How to Add a Repository

  1. Log in to your Odoo Infinity App Store app publisher account.
  2. In the sidebar, select "Repositories".
  3. On the right side of the page, click on the "Add New Repo" button.
  4. A form will pop up, prompting you to add the repository details.
  5. Enter the SSH URL of your repository in the following format:
                                        ssh://[email protected]:username/repository.git#branch
                                    

For example:

                                        ssh://[email protected]:Aniket2200/eg_sale_dynamic_approve.git#17.0
                                    

Where:

  • username is the GitHub username or organization name
  • repository is the name of the GitHub repository
  • branch is the specific branch or tag to use (e.g., 17.0 for Odoo 17)
  • Click the "Submit" button to add your repository.
  • Vendors need to ensure they have the correct SSH key set up in their GitHub account to use this integration.

    Module Structure

    When preparing a module for the Odoo Infinity App Store, you should follow a specific structure to ensure compatibility and proper presentation. Here's the recommended structure for vendor modules:

                                            
                                                module_name/
                                                ├── static/
                                                │ ├── description/
                                                │ │ ├── icon.png
                                                │ │ ├── index.html
                                                │ │ └── gif.png
                                                │ └── img/
                                                │ ├── module_image.png
                                                │ └── index_images/
                                                │ └── (place index.html images here)
                                                ├── models/
                                                ├── views/
                                                ├── security/
                                                ├── data/
                                                ├── __init__.py
                                                ├── __manifest__.py
                                                ├── README.md
                                                └── LICENSE
                                            
                                        

    Explanation of key elements:

    • static/description/icon.png: This is the module icon (128x128 pixels) displayed in the Odoo App Store.
    • static/description/index.html: This HTML file contains the detailed description of your module as it will appear in the App Store. It should include features, screenshots, and any other relevant information.
    • static/description/gif.png: A gif image (560x280 pixels) used at the top of your module's page in the App Store.
    • static/img/: This directory is for any additional images used within your module's interface.
    • static/img/index_images/: This subdirectory contains all images referenced in the index.html file.
    • __manifest__.py: This file contains metadata about your module, including its name, version, dependencies, and other crucial information.
    • README.md: A markdown file providing an overview of your module, installation instructions, and basic usage guidelines.
    • LICENSE: A file containing the full text of the open-source license for your module.

    Additional guidelines:

    • Ensure all images are high quality and properly sized.
    • GIFs can be used in the index.html to demonstrate dynamic features, but keep file sizes reasonable.
    • The index.html should be well-formatted and include CSS for proper styling.
    • All file names should be lowercase and use underscores for spaces.
    • Include clear and comprehensive documentation within your module.
    • Update the index.html file to reference images from the new static/img/index_images/ directory.
    • Choose an appropriate open-source license and include its full text in the LICENSE file.

    Following this structure will help ensure your module is presented effectively in the Odoo Infinity App Store and is easy for users to understand and implement.

    Manifest File (__manifest__.py)

    The __manifest__.py file is a crucial component of any Odoo module. It contains metadata about your module, including pricing information, and is essential for proper integration with the Odoo Infinity App Store. Here's a detailed breakdown of what should be included in your manifest file:

                                            
                                                {
                                                'name': 'Advanced Sales Approval',
                                                'version': '17.0.1.0.0',
                                                'category': 'Sales',
                                                'summary': 'Implement a multi-level approval process for sales orders',
                                                'description': """
                                                This module enhances the standard Odoo sales workflow by adding:
    
                                                * Configurable approval thresholds based on order total
                                                * Multiple approval levels (e.g., manager, director, VP)
                                                * Email notifications for pending approvals
                                                * Detailed approval history and audit trail
                                                * Dashboard for approval status overview
                                                """,
                                                'author': 'YourCompany',
                                                'website': 'https://www.yourcompany.com',
                                                'license': 'LGPL-3',
                                                'depends': ['sale', 'mail'],
                                                'data': [
                                                'security/sales_approval_security.xml',
                                                'security/ir.model.access.csv',
                                                'views/sale_order_views.xml',
                                                'views/res_config_settings_views.xml',
                                                'data/mail_template_data.xml',
                                                'data/ir_cron_data.xml',
                                                ],
                                                'demo': [
                                                'demo/sale_order_demo.xml',
                                                ],
                                                'images': ['static/description/banner.png'],
                                                'installable': True,
                                                'application': False,
                                                'auto_install': False,
                                                'price': 99.99,
                                                'currency': 'EUR',
                                                }
                                            
                                        

    Let's break down each key component:

    • name: The full name of your module as it will appear in the App Store.
    • version: The current version of your module. Follow semantic versioning (MAJOR.MINOR.PATCH).
    • category: The category your module belongs to in the App Store.
    • summary: A brief, one-line description of your module.
    • description: A more detailed description of your module's features and functionality.
    • author: Your company or individual name as the module creator.
    • website: Your company or personal website URL.
    • license: The license under which you're releasing your module (e.g., LGPL-3, OPL-1, etc.).
    • depends: A list of other Odoo modules that your module depends on.
    • data: List of XML files for views, security rules, and other data your module needs to install.
    • demo: List of demo data files, if any.
    • images: Path to the banner image used in the App Store listing.
    • installable: Boolean indicating if the module can be installed (usually True).
    • application: Boolean indicating if this is a full application (False for most modules).
    • auto_install: Boolean indicating if the module should be automatically installed when all its dependencies are satisfied.
    • price: The price of your module in the specified currency.
    • currency: The currency for the price (e.g., 'EUR' for Euros, 'USD' for US Dollars).
    Repository Operations and Vendor Dashboard

    The vendor dashboard provides several crucial operations for managing repositories and their deployment status. Here's an overview of the key features:

    Repository Management

    Secure communication and control of your repositories are managed through SSH keys and operation controls.

    Repository Management Section
    • SSH Key Display: Each of your repositories is listed with its corresponding SSH key of private repository.
    • Edit Button: Next to each SSH key, an edit button allows you to modify the key if necessary.
    • Scan Button: Each repository has a scan button that initiates a scan of your repository to detect any changes or updates. It's useful for ensuring your dashboard reflects the current state of your codebase.
    • Settings Icon: A settings icon for each repository provides access to additional operations:
      • Publish: Makes the repository "Active" and visible in the Odoo Infinity App Store.
      • Unpublish: Reverts the repository to a "Draft" status, removing it from public view.
    • Status Indicator: Each repository displays its current status:
      • Draft: The repository is not currently published and is only visible to you and your collaborators.
      • Active: The repository is live and visible in the Odoo Infinity App Store.

    By effectively utilizing these features, you can maintain control over each of your repositories, managing their visibility and ensuring a smooth experience for users of the Odoo Infinity App Store.

    Vendor Published Apps Display

    As a vendor, you can easily view and manage your published apps in the Odoo Infinity App Store through your dashboard. Here's what you'll see:

    App List

    Published Apps List

    Your dashboard shows a list of all your published apps. For each app, you'll see:

    • App icon and name
    • Company Name
    • Price

    App Details

    App Details View

    For each app, you can quickly:

    • View the app details in the store
    Purchasing Apps

    How To Purchase Apps

    1. Browse the Odoo App Store

    Navigate through categories or use the search function to find the app you need.

    2. Select an App

    Click on the app to view its details, features, pricing, and compatibility information.

    3. Choose Your Version

    Ensure you select the version compatible with your Odoo installation.

    4. Add to Cart

    Click the "Add to Cart" or "Buy Now" button to proceed with your purchase.

    5. Review and Checkout

    Review your cart, then click "Proceed to Checkout" when ready.

    6. Login or Register

    Sign in to your Odoo account or create a new one if necessary.

    7. Complete Payment

    Enter your payment details and confirm your purchase.

    8. Install and Activate

    Download or directly install the app to your Odoo instance. Use the activation key if required.

    Note: Always ensure the app is compatible with your Odoo version before purchasing. Some apps may offer a trial period - take advantage of this to test before buying.

    Terms and Conditions

    By accessing or using the Odoo Infinity App Store, you agree to comply with and be bound by these Terms and Conditions. If you do not agree to these terms, please do not use our services.

    2.1. You must create an account to use certain features of the App Store.

    2.2. You are responsible for maintaining the confidentiality of your account information.

    2.3. You agree to provide accurate and current information during the registration process.

    3.1. Vendors must comply with all guidelines for app submission and maintenance.

    3.2. Vendors are responsible for the content and functionality of their apps.

    3.3. Vendors must ensure their apps are compatible with the specified Odoo versions.

    4.1. Vendors retain ownership of their apps and related intellectual property.

    4.2. By submitting an app, vendors grant the App Store a license to distribute and promote the app.

    5.1. All purchases are final unless otherwise stated.

    5.2. Refund requests will be considered on a case-by-case basis.

    6.1. Our Privacy Policy governs the collection and use of user data.

    6.2. Vendors must comply with applicable data protection laws.

    7.1. Users and vendors are prohibited from posting or distributing harmful, illegal, or offensive content.

    7.2. Any attempt to disrupt or abuse the App Store services is strictly prohibited.

    8.1. We reserve the right to modify or discontinue the App Store service at any time.

    8.2. We will strive to provide reasonable notice of any significant changes.

    9.1. The App Store is provided "as is" without warranties of any kind.

    9.2. We shall not be liable for any indirect, incidental, or consequential damages.

    These Terms and Conditions shall be governed by and construed in accordance with the laws of [Jurisdiction], without regard to its conflict of law provisions.

    If you have any questions about these Terms and Conditions, please contact us at [contact email].
    Troubleshooting the Odoo Infinity App Store

    While using the Odoo Infinity App Store, you may encounter some issues. This guide will help you troubleshoot common problems and ensure a smooth experience. Here are some common issues and their solutions:

    Common Issues and Their Solutions

    1. Unable to log in to the App Store
      • Verify your username and password are correct.
      • Clear your browser cache and cookies.
      • Try using a different browser or incognito mode.
    2. App installation fails
      • Check your Odoo version compatibility with the app.
      • Ensure you have necessary permissions to install apps.
      • Verify your internet connection is stable.
    3. GitHub collaboration invitation not received
      • Double-check the App Store admin's GitHub username.
      • Check your GitHub account's notification settings.
      • Look in your email spam folder for the invitation.
    4. App not appearing in the store after submission
      • Ensure all required information is provided in your submission.
      • Check if your app meets all guidelines and requirements.
      • Allow for processing time (usually 24-48 hours).
    5. Vendor facing GitHub login issues or access denied messages
    6. Check and add your public email address:
      • Go to your GitHub account settings.
      • Navigate to the "Emails" section.
      • Check if you have a public email address added.
      • If not, add a public email address and update your settings.
      • Make sure to verify the email address if required.

    Note: If you continue to experience issues after trying these solutions, please contact the Odoo Infinity App Store support team. They can provide further assistance and address any specific problems you may be facing.