-
-
Notifications
You must be signed in to change notification settings - Fork 792
DFC Guide
Filipe edited this page Nov 27, 2025
·
5 revisions
This section contains a first attempt to gather information on the Shopify/OFN integration, and provide an overview on features and setup steps.
- 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

- 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.
Connecting with DFC should be possible with all three available staging servers (AU, UK, FR).
testdfc@protonmail.com, details are on Bitwarden.
- 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.
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
- Design styleguide: colors and shadows
- Design styleguide: fonts and text styles
- Design styleguide: size and spacing
- Design styleguide: icons
- Design styleguide: links and buttons
- Design styleguide: navigation and menus
- Design styleguide: tables
- Email templates
- Design tools
Product