Documentation
Installation instructions
You can install extension using Extension Installer or manually. In the latter case unpack and upload all folders from "upload" directory to the root of your store. If there's install.xml file in the package, rename it to extension_name.ocmod.xml, replacing "extension_name" with extension's name (or any other name), and upload it to "system" folder. When upgrading from previous version simply rewrite all existing files. Refresh modifications cache from Extensions -> Modifications page (not needed if install.xml file is not included in the package).
Note for OpenCart 3 users
If you see "The directory is not allowed to be written to" error message, download OpenCart 3.0 Extension Installer Fix from this page and install it. Then install the main extension.
Note for OpenCart 2.0.X users
Sometimes OCMod inserts modification in multiple files, which are separated by "|" character in XML-file. On earlier OpenCart 2 versions a comma was used instead. To quickly fix this, open XML file (usually, install.xml) and replace all occurrences of "|" character with "," for "path" attribute in every applicable <file> element. Search for "<file path=" to quickly find and highlight all elements.
If after installation you have "Permission denied" issue when accessing Modules, Shipping, Payments, Order Totals (or any other) section of Extensions menu, remove "module", "shipping", "payment", "total" (or any other) folder from "admin/controller/extension" directory. Same for "admin/language/en-gb/extension" directory. For example ("module" should be removed from both paths):
admin/controller/extension/module
admin/language/en-gb/extension/module
Permissions
In some cases it is required to manually set permissions for installed extension. To do this go to System -> User Groups, find your group and select access/modify permissions for desired extension. You can find extension in permissions list by folder/filename pair (for example, marketing/acoupon).
Extension Setup
Setup SumUp Application
Login to you SumUp account, click the top-right menu and select For Developers. Fill the form in Consent Section, save it and then click Create Client Credentials button below. Another form will be displayed. Select Web as Application Type, enter application name, copy redirect URL from extension settings to Authorized Redirect URL field and save. Download .json file with application credentials and copy Client ID and Client Secret values to corresponding fields in extension settings. Set up the rest accordingly. Now you need to visit SumUp for Developers page and send a request to SumUp support asking them to enable 2 additional authorization scopes: "payments" and "payment_instruments".
Options
Each option has a short hint, which explains the basics. Below are more detailed explanations:
- Cron URL - Link to run the script manually or use in cron command. Used for checking transaction status of pending orders.
- Cron Secret - Secret key for action link to increase security.
- Redirect URI - Your SumUp application's Authorized Redirect URI, which you have to enter in application settings.
- Client ID - Your SumUp application Client ID.
- Client Secret - Your SumUp application Client Secret.
- Google Groups - Google Contacts groups to sync with. List of groups is taken automatically from your Google account.
- Data to Sync - Customer data you want to sync with Google Contacts. You must select at least one item or no syncing will occur.
- Include Disabled - Sync disabled customers as well.
- Only Approved - Only approved customers will be synced.
- Send Report - Full job report will be sent to admin store email after every run.
- Debug - Add Google response contents to report. This is useful, if you're having issues with syncing and want to understand why.
- Stores - Customers will be limited to selected stores.
- Customer Groups - Customers will be limited to selected groups.
- Status - Disables or enables extension.