# Varbase Users Base

The **Varbase Users Base** recipe manages default Varbase user roles and user management configurations, including role definitions, account settings, and the modules needed to support user management on the site.

## Drupal.org Project

<https://www.drupal.org/project/varbase_users_base>

## Overview

Varbase Users Base establishes the foundation for user management in Varbase sites. It defines the user roles hierarchy, configures registration and notification policies, and sets account defaults to provide a secure and streamlined editorial experience.

## Included Modules

Brings in the following core modules to your site:

| Module                                                                  | Purpose                                                                                                         |
| ----------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Node** *(in Drupal core)*                                             | Manages the creation, configuration, and display of the main site content.                                      |
| **Block** *(in Drupal core)*                                            | Allows users to configure blocks (containing content, forms, etc.) and to place them in the regions of a theme. |
| [**Persistent Login**](https://www.drupal.org/project/persistent_login) | Provides "remember me" functionality for users with secure long-lived login tokens.                             |

## User Roles

Varbase comes with pre-configured default roles tailored for sites with hierarchical content management permissions.

### Super Admin (`administrator`)

Can edit everything in content and configurations for the site.

### Site Admin (`site_admin`)

Can edit, delete, and publish all content on the site.

### SEO Admin (`seo_admin`)

Can edit items related to SEO, Meta tags and Google Analytics.

### Content Admin (`content_admin`)

Can edit all content and publish it but cannot edit anything else not related to the content roles.

### Content Editor (`content_editor`)

Has permissions to edit all content on the website but cannot publish any content.

### Authenticated user (`authenticated`)

Any user who can access the website by providing a username or password. This role is provided by default from Drupal and cannot be edited or deleted.

### Anonymous user (`anonymous`)

Any visitor who can access the website without providing a username or password. This role is provided by default from Drupal and cannot be edited or deleted.

## Configuration

The recipe applies the following account settings:

| Setting                          | Value                    |
| -------------------------------- | ------------------------ |
| Registration                     | Administrators only      |
| Email verification               | Disabled                 |
| Password reset timeout           | 24 hours (86400 seconds) |
| Password strength indicator      | Enabled                  |
| Cancel method                    | Block account            |
| Notify on admin-created accounts | Enabled                  |
| Notify on password reset         | Enabled                  |
| Notify on account activation     | Enabled                  |
| Notify on account blocked        | Disabled                 |
| Notify on account canceled       | Disabled                 |

## Installation

Apply the recipe using Drush:

```bash
ddev drush recipe ../recipes/varbase_users_base
```

This recipe is automatically applied when using the Varbase Starter recipe and should be one of the first recipes applied as other recipes may depend on user role configurations.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.varbase.vardot.com/developers/understanding-varbase/varbase-recipes/varbase-users-base.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.