diff --git a/docs/source/quick-dynamic.rst b/docs/source/quick-dynamic.rst index b11af65..0685aec 100644 --- a/docs/source/quick-dynamic.rst +++ b/docs/source/quick-dynamic.rst @@ -6,12 +6,30 @@ If your QGIS Project uses an existing PostGIS database, you need to enter the Se You can connect to a PostGIS Data Source using below. -On the Connections page, enter the connection details for your PostGIS or Server connection(s) +Click PostGIS on the left menu and then click Add New - .. image:: images/qwc_service_name.png + .. image:: images/PostGIS-1.png + + +Enter the requied PostGIS information + + .. image:: images/PostGIS-2-Existing.png .. warning:: Be sure to enter the Service name. Your QGIS Project uses the Service name for connections. -You can add an unlimited number of Service names. +Click Next + + .. image:: images/PostGIS-3-Existing.png + + +Select the database you wish to connect to and click Next + + .. image:: images/PostGIS-4-Saved-Existing.png + + +Your PostGIS data source has now been added + + + .. image:: images/PostGIS-5-Saved-Existing.png diff --git a/docs/source/quickstart.rst b/docs/source/quickstart.rst index 798b9c5..cd2f663 100644 --- a/docs/source/quickstart.rst +++ b/docs/source/quickstart.rst @@ -10,7 +10,7 @@ Note that each item is covered in detail in subsequent sections of this document 1. Install the QGIS Plugin. ~~~~~~~~~~~~~~~~~~~~~~~~~~ - .. image:: images/plugin-install +.. image:: images/plugin-install.png 2. Launch Plugin @@ -18,7 +18,7 @@ Note that each item is covered in detail in subsequent sections of this document Launch the plugin by going to Web > QWC2 -.. image:: images/qwc_service_name.png +.. image:: images/plugin-1.png @@ -26,20 +26,25 @@ Launch the plugin by going to Web > QWC2 3. Enter Server Information ~~~~~~~~~~~~~~~~~~~~~~~~~~ -Enter your credentials +Click Configure on the left menu and enter your credentials 1. In the QWC2 plugin, give your server a name 2. Enter your hostname (e.g. geo.webgis1.com) 3. Enter your email and password 4. Click Save + +.. image:: images/plugin-2.png + .. note:: Close the plugin and open it again if the Server is not visible immediately. +.. image:: images/plugin-3.png -4. Create Tenant + +4. Create Tenant (Optional) ~~~~~~~~~~~~~~~~~~~~~~~~~~ While not required, it is strongly recommended to create at least one new Tenant. @@ -53,7 +58,7 @@ Click Tenant on the left menu, give your Tenant and name and click Create You should see a success message like below -.. image:: images/plugin-6-create-Tenant +.. image:: images/plugin-6-create-Tenant.png .. note:: @@ -61,32 +66,65 @@ You should see a success message like below -4. Go to Maps > Add New +5. Upload ~~~~~~~~~~~~~~~~~~~~~~~~~~ -Give your map a name and description and select the QGIS Project from the dropdown +Click Upload on the left menu -.. image:: images/qwc_map.png +.. image:: images/plugin-7-create-Tenant.png + +Select Server (if more than one) and Tenant from the dropdowns. + +Check the Configure button to automatically run the QWC2 Configure Utility + +.. image:: images/plugin-7-create-Tenant.png -There are a large number of features and options, but for now, just go scroll down to Security and select the existing User Group +Click Upload - .. image:: images/Quick-Start-Login-12.png +.. image:: images/plugin-9-create-Tenant.png + +On successful upload it should appear as below -Click Create +.. image:: images/plugin-10-create-Tenant.png + + +6. Publish ~~~~~~~~~~~~~~~~~~~~~~~~~~ -ON the home page, click the link to your new map: +Click Publish on the left menu - .. image:: images/Quick-Start-Login-14.png + +.. image:: images/plugin-11-create-Tenant.png + + +Select Server, Tenant, Theme (QGIS Project). Give your Map a name a description. + +Select if Map should be Public or not. If not Public, assign Groups that will have access. + +If you have not created any Groups yet, there will be only a Default Group + +.. image:: images/plugin-12-create-Tenant.png + +.. note:: + If you have created mutliple Tenants, be sure to connect as the correct Tenant + +You should now see a Success message like below with link to view the published Map + +.. image:: images/plugin-13-create-Tenant.png + +View the Map to verify everything is in oder + +.. image:: images/Plugin-Done.png Your map has been published! ~~~~~~~~~~~~~~~~~~~~~~~~~~ - .. image:: images/qwc_published.png + .. note:: + All settings can be modified via your QWC2 Control Panel after publication as well.