# Introduction to Administering GeoNode (Basics) 
- Sign in as `admin`

    ![image](./img/admin_signin.png)

- Note that as a `superuser`, you will have more options available from the profile dropdown menu.

    ![image](./img/admin_option.png)

- Click on `Admin` To get redirected to the `Django Administration Dashboard`

    ![image](img/125767714-138a24da-4aed-4ee7-936f-6cf11f3a95e9.png)

## Django Administration Dashboard
The dashboard, at least on GeoNode, is a special section that is only accessible to `superusers`.

Through the dashboard, an `admin` can access special functions and can interact directly with the models stored in the DB.

This is particularly useful when we need to recover from an unusual situation (e.g. a layer could not successfully finish the configuration or an error occurred in the meanwhile).

Note that the dashboard is composed of several sections. In this introductory module, we will focus on the most common ones.

### Announcements
![image](img/131642298-4c9959b2-cc4b-4f6b-8451-e2da1176295b.png)

This section allows an `admin` to create, or change, public announcements on the portal.

There are several types of announcements. They can be `public` (which means anyone will see them) or `Members Only` (which means that only registered users will be able to see them).

**Important**: _Remember, when creating a new announcement, make sure the_ `Site Wide` _option is enabled_
      ![image](img/131643156-15e23388-c3fb-4e2e-b05e-d3bfa0922af1.png)


### Base Administration
![image](./img/base_admin.png)

This section allows an `admin` to customize some of the default metadata content on GeoNode, such as:
- Licenses 
- Subject Matter
- Keywords
- Metadata Regions

Not all sections can be changed.
**Warning**: _Only change that content if you know what you are doing!_

### People
![image](img/131837708-c883e372-9ff8-4086-b9c6-483313dbfd03.png)

This section enables an `admin` to manage the system's `users` (i.e. the registered members).

Through this panel, it is possible to do the following:

- Create/modify/delete users
- Disable users or update/change their passwords 
- Promote a user to `superuser`

### Resources: Documents, Geoapps, Datasets, and Maps
![image](./img/resources_1.png)
![image](./img/resources_2.png)
![image](./img/resources_3.png)

This section allows an `admin` to manage the GeoNode `resources`.

Through this panel, it is possible to:

 - Modify/delete resources
 - Publish/unpublish resources

### GeoNode Themes Library
![image](./img/themes.png)

This section allows an `admin` to manage the GeoNode `simple themes`.

For more information, please check the GeoNode documents section [Simple Theming](https://docs.geonode.org/en/master/admin/admin_panel/index.html#simple-theming).

## Advanced Workflow
By default GeoNode is configured to make every resource suddenly available to everyone, i.e. publicly accessible even from anonymous/non-logged in users.

To enable advanced workflow in Geonode, You will have to configure the following settings to True

- RESOURCE_PUBLISHING
- ADMIN_MODERATE_UPLOADS

With the advanced workflow enabled, your resources won’t be automatically published (i.e. made visible and accessible for all, contributors or simple users).

For now, your item is only visible by yourself, the manager of the group to which the resource is linked (this information is filled in the metadata), the members of this group, the members of the group the owner belongs to, and the GeoNode Administrators.

Before being published, the resource will follow a two-stage review process, which is described below:

![image](./img/adv_data_workflow_001.jpg)

In summary, When advanced workflow is enabled, we expect the following:

- The “unpublished” resources will be hidden to anonymous users only. The registered users will be still able to access the resources (if they have the rights to do that, of course).

- The owner’s Groups are automatically allowed to access the resource, even if the “anonymous” flag has been disabled. Those permissions can be removed later on.

- The managers of the owner’s Groups associated to the resource, are always allowed to edit, approve and publish the resource, the same as they are admin for that resource.

- The Manager must check that the metadata are properly completed and that the mandatory information (Title, Abstract, Edition, Keywords, Category, Group, Region) are filled.

- If needed, the Manager can contact the contributor responsible of the dataset, document or map in order to report potential comments or request clarifications.

- Members of the group can also take part in the reviewing process and give some potential inputs to the responsible of the dataset, document or map.

- When the Manager considers that the resource is ready to be published, he should approve it. To do so, the Manager goes to the resource detail page, then opens the Edit Metadata. In the Settings tab, the manager checks the Approved box, and then updates the metadata and saves the changes:

- After the resource is approved, owner is no longer able to modify it. He will see new button on the resource detail page: `Request change`. After clicking this, view with short form is shown. On this view user can write short message why he want to modify the resource. This message will be sent through messaging and email system to administrators:

- If the administrator unapprove the resource, the owner is again able to modify it.

- Following this approval, the GeoNode Administrators receive a notification informing them that an item is now waiting for publication

- Prior to the public release of an approved resource, the Administrator of the platform performs a final validation of the item and its metadata, notably to check that it is in line with license policies.

- If needed, the GeoNode Administrator can contact the Manager who has approved the resource, as well as its responsible.

- Once the resource is validated, the item is made public by the Administrator. It can now be viewed, accessed, and downloaded in accordance with the Permissions set by the responsible contributor.

Let's create a resource eg, a document when Advanced workflow is enabled.

Update environment variables below and restart server.

    RESOURCE_PUBLISHING=True
    ADMIN_MODERATE_UPLOADS=True

Using the Admin panel, create the following test users and groups

![image](./img/test_groups.png)
![image](./img/test_users.png)

Add users to groups with their respective roles as below:

    Test group 1:
    - test_user1@gmail.com - Member
    - test_user2@gmail.com - Member
    - test_manager1@gmail.com - Manager

    Test group 2:
    - test_user3@gmail.com - Member

    Test resource group:
    - test_manager2@gmail.com - Manager

Login as test_user1@gmail.com and from the `Add Resource` dropdown menu, select `Upload document`.

![image](./img/upload_document_link.png)

You will be redirected to a page allowing you to add a new *document* to GeoNode. On the `Upload Document` page, click on `Select files`; that will open your system file browser. Go to `/opt/data/sample_data/documents` location, Select the file `images/flowers.png` and click `Open`; GeoNode will automatically set the document `title` equal to the `file name`.

Click on `Upload` and wait for GeoNode to finalize the procedure. After the upload, you can click in `view` button and you will be redirected to the document details page.

![image](./img/adv_upload_1.png)

Click on `Edit > Edit Metadata` and assign group `Test resource group` to the resource. Notice that the approve and publish options are False and disabled for the owner.

![image](./img/adv_metadata_1.png)

Logout from the system and search for the document as annonymous user. The document will not be visible.

![image](./img/adv_metadata_2.png)

Login as `test_user2@gmail.com` (a member in the owner's group) and search for the document. The document will be visible but the user will not have the edit option.

![image](./img/adv_metadata_3.png)

Login as `test_manager1@gmail.com` or `test_manager2@gmail.com`. Click on `Edit > Edit Metadata`. Under the setings tab, approve the resource and update.

Now login as `test_user1@gmail.com` (owner) Notice that the edit option is nolonger available.

As an admin, Click on `About > Groups`. Select `Test resource group` then click on `Manage Group Members`. Demote user `test_manager2@gmail.com`.

![image](./img/adv_groups.png)

Notice that user `test_manager2@gmail.com` can see the resource but unable to edit or approve it.

Login as an Admin and publish the resource.

Notice the resource is now visible to Annonymous users.
![image](./img/adv_metadata_4.png)

#### [Next Section: Mastering GeoNode data publishing and management (GN2)](GN2)