# Front Page

{% hint style="danger" %}
**Please note:** This page is under construction and has not been finished yet.
{% endhint %}

## Introduction

The Front Page settings control the pages that are shown to the visitors of your website. There are two types of pages that can be defined: 

| Page            | Description                                                         |
| --------------- | ------------------------------------------------------------------- |
| Home Page       | The page that is used when accessing the 'home' of your website.    |
| Post-login page | The page that is used after a user has logged in onto your website. |

Each of these pages can be different for different [User Classes](/administration/users/user-classes.md)

To determine which page is shown, the [Front Page Rules](/administration/settings/front-page.md) are used. 

{% hint style="info" %}
By default, when no settings are changed, the `news.php` (News) page is shown.

**TODO: CHECK TO BE SURE. IS IT WELCOME MESSAGE NOW?**
{% endhint %}

## Front Page Rules

The screen displays a list of current rules, including the default rule which is shown below:

| Order | User Class        | Home Page | Post-login page |
| ----- | ----------------- | --------- | --------------- |
| 1     | Everyone (public) | News      | None            |

The rules are searched in order. The first rule that matches the current user is applied. That rule then determines the Home Page and, if set, the Post-login page, for that specific user. 

* Their order can be changed by clicking on the arrows. 
* Rules may be deleted by clicking on the 'Delete' icon, or edited by clicking on the 'Edit' icon.
* To add a new Front Page Rules, click the [**Add new rule**](/administration/settings/front-page.md#create-new-front-page-rules) button.

{% hint style="info" %}
If no matching rule is found: .... **TODO:** check (news.php, welcome message?)
{% endhint %}

{% hint style="info" %}
**TODO:** add example with different userclasses to clarify the ordering system
{% endhint %}

## Create new Front Page Rules

There are two tabs: one for defining the `Home Page` and one for defining the `Post-login page`. 

* For each tab, you can select an area of your website that will be shown. You can also choose to define a *Custom URL* to link to another website for example. 

{% hint style="info" %}
Some plugins have specific Frontpage settings. When such a plugin is installed, you will find those settings listed here as well. 
{% endhint %}

* You can then specify to which **User Class** the rule is applied. Each rule can be applied to  everybody on your website or only to specific groups of users (such as guests). <br>
* To save the Front Page rule, click the "Update" button.&#x20;


---

# 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://userguide.e107.org/administration/settings/front-page.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.