mirror of
https://github.com/openfoodfoundation/openfoodnetwork
synced 2026-01-11 18:26:50 +00:00
Page:
DFC Guide
Pages
API Development
API documentation
Angular and OFN
Authentication
Automated Testing Gotchas
Bug severity
Bulk Edit Products admin interface
Code, the way we do things (2018)
Code Conventions
Code review process
Configuration
Continuous Integration
Creating new components
DFC Guide
Data initialization bootstrapping, seeding, and importing data
Data migration
Data model diagram (ERD)
Database migrations
Dependency updates
Design styleguide: colors and shadows
Design styleguide: fonts and text styles
Design styleguide: icons
Design styleguide: links and buttons
Design styleguide: navigation and menus
Design styleguide: size and spacing
Design styleguide: tables
Design tools
Developer Guidelines
Developer Manual
Development Environment Setup: Debian
Development Environment Setup: Fedora
Development Environment Setup: OS X (El Capitan)
Development Environment Setup: OS X (Mavericks)
Development Environment Setup: OS X
Development Environment Setup: Ubuntu
Development Environment Setup: Windows
Development Environment Setup: macOS (Sierra, HighSierra, Mojave and Catalina)
Docker: useful tips and commands
Emails
Enterprises login
Feature Testing Handbook
Feature template (epic)
Feature toggle with Flipper
Feature toggles
Home
How to do Code Reviews
Integration & API
Internationalisation (i18n)
Karma
Learning Rails
Locale and sample data
Making a great commit
Making a great pull request
Maps
Matomo Integration
Mexico
Overview
Parallelized test suite with knapsack
Patch Releases
Permissions
Pipeline development process
Product amounts units
Release testing automation
Releasing
Rubocop
Sales Tax
Set and Deploy on Heroku
Setting up Stripe in your local environment
Setting up Stripe on an OFN instance
Skylight setup
Slack notifications from GitHub
Spree Commerce customisation
Staging with Github Actions
Stimulus
Stripe testing
Stripe
Tech Doc: App Routes
Tech Doc: Checkout workflow
Tech Doc: OFN's Spree fork🍴
Tech Doc: OFN Data Model Single shipment per Order
Tech Doc: OFN Data Model Stock locations
Tech Doc: OFN Data Model
Tech Doc: Orders and Adjustments updates
Tech Doc: Scoping Variants and Products to Hubs with VariantOverrides
Testing GitHub Actions Locally with act
Testing Subscriptions
Testing and Rspec Tips
Testing process
The process of review, test, merge and deploy
Troubleshooting your instance
Turbo
Variant Overrides
Who
i18n
Clone
5
DFC Guide
Filipe edited this page 2025-11-27 18:11:36 +00:00
This section contains a first attempt to gather information on the Shopify/OFN integration, and provide an overview on features and setup steps.
Table of contents
Setup guide for testing
How do I connect to DFC? ⚡
- Enable the feature toggle for connected_apps
- Visit the Connected Apps setting on the Configuration section, and check the option DFC anonymized orders API for research purposes ; Click Update.
- Visit /admin/enterprises/oidc_settings and login with the OIDC test account
Troubleshoot 🔧
- If you're getting an error stating that the account is already being used elsewhere, you can:
- visit https://login.lescommuns.org/auth/realms/data-food-consortium/account/#/
- verify the account is being used under Applications
- eventually disconnect the account and try again
- If your're getting 403 Faraday error - Backorder failed (seen on Bugnsnag notifications, and per Email)
The hub's email needs to be added to the customer list (on the Shopify profile), and respectively approved:
So, login to the Shopify account; visit the authorized customers section (to be verified...), add the Hub's email and approve it. The error should now stop occurring.
Which server can I use?
Connecting with DFC should be possible with all three available staging servers (AU, UK, FR).
Which account should I use?
testdfc@protonmail.com, details are on Bitwarden.
How do I import products?
- After connecting the staging server (or using -UK, -FR) and your account, visit the product import page.
- Visit /admin/product_import
- Scroll to bottom, enter URL of a DFC products endpoint, eg: https://env-0105831.jcloud-ver-jpe.ik-server.com/api/dfc/Enterprises/test-hodmedod/SuppliedProducts https://staging.openfoodnetwork.org.au/api/dfc/enterprises/{id}/catalog_items (where id is the db id of an enterprise that your user has management role for) Select enterprise to import into
- Click "Preview"
- Summary should be shown with correct info.
- Click import. The correct number of products should be imported.
Order Cycle and Product Sync
Order Cycle Setup
Useful Links
Home
Development environment setup
- Pipeline development process
- Bug severity
- Feature template (epic)
- Internationalisation (i18n)
- Dependency updates
Development
- Developer Guidelines
- The process of review, test, merge and deploy
- Making a great commit
- Making a great pull request
- Code Conventions
- Database migrations
- Testing and Rspec Tips
- Testing GitHub Actions Locally with act
- Automated Testing Gotchas
- Rubocop
- Angular and OFN
- Feature toggles
- Stimulus and Turbo
Testing
- Testing process
- OFN Testing Documentation (Handbooks)
- Continuous Integration
- Parallelized test suite with knapsack
- Karma
Releasing
Specific features
Data and APIs
- API documentation
- Authentication
- Integration & API
- Data migration
- Data model diagram (ERD)
- Stripe
- DFC Guide
Instance-specific configuration
External services
Design