addons-cm/website_sale_aplicoop/readme/USAGE.md
snt 6fbc7b9456 [FIX] website_sale_aplicoop: Remove redundant string= attributes and fix OCA linting warnings
- Remove redundant string= from 17 field definitions where name matches string value (W8113)
- Convert @staticmethod to instance methods in selection methods for proper self.env._() access
- Fix W8161 (prefer-env-translation) by using self.env._() instead of standalone _()
- Fix W8301/W8115 (translation-not-lazy) by proper placement of % interpolation outside self.env._()
- Remove unused imports of odoo._ from group_order.py and sale_order_extension.py
- All OCA linting warnings in website_sale_aplicoop main models are now resolved

Changes:
- website_sale_aplicoop/models/group_order.py: 21 field definitions cleaned
- website_sale_aplicoop/models/sale_order_extension.py: 5 field definitions cleaned + @staticmethod conversion
- Consistent with OCA standards for addon submission
2026-02-18 17:54:43 +01:00

2.2 KiB

Creating a Group Order

  1. Go to Website Sale > Group Orders > Create

  2. Fill in the order details:

    • Order Name: Descriptive name (e.g., "Weekly Vegetable Order")
    • Start Date: When the order opens for shopping (leave empty for orders that are always open)
    • End Date: When the order closes (optional; leave empty for permanent orders)
    • Cutoff Day: Day of week when purchases stop (0=Monday, 6=Sunday) - mandatory
    • Recurrence Period: How often the order repeats (once, weekly, biweekly, monthly)
    • Suppliers: Link to product suppliers (informational)
    • Products: Products available in this order (REQUIRED - add via the "Products" tab)
    • Categories: Product categories available in this order (informational)
    • Groups: Which user groups can participate (REQUIRED - users from these groups can shop)
  3. Assign Products: Click on the "Products" tab and add all products that should be available for this order

  4. Click Save and transition the order to Open state to allow shopping

Note on Start Date

  • If Start Date is empty, the order is considered always open (ignoring date range checks)
  • If Start Date is set, the order is only active starting from that date
  • Use empty Start Date for orders that should always be available during their time window

Shopping for a Group Order

  1. Navigate to the website storefront at /eskaera (group orders page)
  2. View active group orders for your participating groups
  3. Select an order to view available products
  4. Add products to your cart (separate cart per order)
  5. At checkout, confirm your order to convert items to a sales order draft
  6. Proceed through standard Odoo checkout workflow

Configuration

Managing Groups

  1. Go to Contacts > Groups (res.partner with is_group=True)
  2. Create groups for user communities
  3. Add partners/users to groups via the Members tab

Managing Products

  1. Products are linked to group orders via the Group Orders field in product settings
  2. Set pricing and availability per group order
  3. Assign products to categories used in group orders

Date & Time Validation

  • start_date must be ≤ end_date (when both filled)
  • Empty end_date = permanent order