# README

[![Release](https://img.shields.io/badge/release-0.1-a2cbe9.svg)](https://git.dotclear.watch/JcDenis/FrontendSession/releases)
![Date](https://img.shields.io/badge/date-2024.12.31-c44d58.svg)
[![Dotclear](https://img.shields.io/badge/dotclear-v2.33-137bbb.svg)](https://fr.dotclear.org/download)
[![Dotaddict](https://img.shields.io/badge/dotaddict-official-9ac123.svg)](https://plugins.dotaddict.org/dc2/details/FrontendSession)
[![License](https://img.shields.io/badge/license-GPL--3.0-ececec.svg)](https://git.dotclear.watch/JcDenis/FrontendSession/src/branch/master/LICENSE)

## ABOUT

_FrontendSession_ is a plugin for the open-source web publishing software called [Dotclear](https://www.dotclear.org).

> Allow session on frontend.

## REQUIREMENTS

* Dotclear 2.33
* PHP 8.1+
* Dotclear admin permission for configuration
* Dotclear contentadmin permission for management
* System writable directory on public path to store picture
* Note: it also creates dedicated database tables

## USAGE

First install _FrontendSession_, manualy from a zip package or from 
Dotaddict repository. (See Dotclear's documentation to know how do this)

Once it's done you can manage FrontendSession option from from blog preferences.

There are templates for public page. These template is adapted to 
default Dotclear's theme. If you want to create your own template 
for your theme, copy files from FrontendSession/default-templates 
to your theme tpl path and adapt them.

This plugin only manage sign in and session on public pages, nothing more.
Users must exist on Dotclear's database and have rights permissions.
Features enabled by session must be done by others plugins.

## LINKS

* [License](https://git.dotclear.watch/JcDenis/FrontendSession/src/branch/master/LICENSE)
* [Packages & details](https://git.dotclear.watch/JcDenis/FrontendSession/releases) (or on [Dotaddict](https://plugins.dotaddict.org/dc2/details/FrontendSession))
* [Sources & contributions](https://git.dotclear.watch/JcDenis/FrontendSession) (or on [GitHub](https://github.com/JcDenis/FrontendSession))
* [Issues & security](https://git.dotclear.watch/JcDenis/FrontendSession/issues) (or on [GitHub](https://github.com/JcDenis/FrontendSession/issues))

## CONTRIBUTORS

* Jean-Christian Denis (author)

You are welcome to contribute to this code.