The Arches QGIS plugin allows you to connect to your Arches project and create new resources or edit existing Arches resource geometries using QGIS layers.
The plugin is still in development and thus marked as "experimental". Be aware that since the plugin is currently experimental, there may be some unknown issues/bugs and the creators of the plugin can not be held accountable for any problems that may occur.
If you encounter any issues, don't hesitate to create a new GitHub issue or contact the plugin creators.
- A running Arches instance, accessible via a public domain or IP.
- An Arches user login with permissions to enter data or create resources.
- A registered oauth application and client ID entered into settings.py (or settings_local.py) - see the following documentation link for more information on registering oauth2 applications.
- If you wish to edit existing Arches resources, a database connection with spatial views added as QGIS layers is required.
Since the plugin is experimental, to install the plugin through the QGIS plugins repository you will need to ensure that experimental plugins are enabled.
- Navigate to the Plugins tab, then "Manage and Install Plugins".
- Navigate to "Settings".
- Tick "Show also Experimental Plugins". Once enabled, head back to all plugins, search for "Arches Project" and hit "Install Experimental Plugin".
All QGIS plugins can be viewed and downloaded from the QGIS website
- Search for the "Arches Project" plugin on the website, or go directly here https://plugins.qgis.org/plugins/arches_project/.
- Download the plugin zip.
- Extract the folder, and move it to your local QGIS installation path (see below).
- Find your local path for the QGIS installation:
If on Windows, this should look similar to
C:\Users\USERNAME\AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins\If on MacOS, this should look similar to/Users/USERNAME/Library/Application Support/QGIS/QGIS3/profiles/default/python/plugins/ - Clone this repository under the respective plugins path.
git clone https://github.com/archesproject/arches-qgis.git
- Head to the QGIS Plugins tab and select "Manage and Install Plugins".
- Search for and select "Arches Project" from the list of all plugins.
If you wish to develop with the QGIS Arches plugin, below are some helpful tips that will help, and make life easier.
- Installation via GitHub is the easiest method to develop. This can be done by git cloning in the plugins path (shown above) and (optionally) creating a symbolic link to somewhere much easier to find e.g. your home directory.
- The QGIS plugin "Plugin Reloader" is incredibly useful for reloading plugins to reflect code changes. This can be found on the QGIS plugins repository, and configured to reload specific plugins with Ctrl+F5.
QGIS uses PyQt as the framework for UI, specifically Qt 5.15.
Note: Qt 5.15 binaries do not appear to be available for ARM Macs. The following instructions should work for Windows and Linux users.
If you wish to develop UI elements for the arches-qgis plugin you'll need to install Qt Creator, an IDE for Qt applications.
It's recommended to install Qt and QtCreator using the online installer found here: https://www.qt.io/download-qt-installer-oss. Bundled is a Maintenance Tool that makes updating, and installing/uninstalling additional components very easy.
Offline, version-specific packages for Qt and QtCreator can be downloaded here: https://www.qt.io/offline-installers.
QtCreator uses Qt6 out the box, so you'll need to use the Qt Mainentance Tool to install the archived version of Qt 5.15.
- In the top right "Show" dropdown ensure that "Archive" is selected in order to see all historical versions of Qt.
- Locate and expand Qt 5.15.2, and ensure only the "MinGW 8.1.0" compiler is checked.
Once installed, add the new version of Qt as a kit in the QtCreator preferences, see the documentation for more information: https://doc.qt.io/qtcreator/creator-targets.html.
Open a new project in QtCreator by selecting the .pro file found in arches_project/ui/arches_project_ui.pro, and Qt 5.15.
This .pro file will load all plugin .ui files into the project tree found in the Edit tab (on the left side of QtCreator) where they can be easily opened and switched between.