Version 3.0.0¶

We are very pleased to release this version of LiberaForms that includes; an improved code base, a new user interface, and many new features.
Enjoy!

Changes¶

To mention a few..

User interface¶

The interface layout is completely new. We hope you like it!

Forms¶

Form management work flow has been redesigned
Forms can be styled
An API endpoint to GET form answers in json

Answers¶

Changes to answers are logged and can be compared
Anonymous users can edit their answers

Inline help¶

We've added a help icon to the interface that displays contextual help that corresponds to the page at hand.

Includes:

One help page for each application page
A menu to browse the help

Alerts¶

Alerts are displayed when users need to know or be reminded of something, for example:

Their assigned disk space is full
A form is being edited

Privacy statements¶

Version2 introduced the option to include a privacy policy to the forms.

Version3 takes this idea much further and makes privacy statements an integral part of configuring a form.

Users may manage statements as templates or create statements on-the-fly.

Statement wizard¶

Because most users do not have their own personalized Privacy policy text, or because many people to not know how to prepare one, LiberaForms includes a Wizard to help generate such texts.

Custom translations¶

Administrators can define which languages are available to translate parts of the application like:

The /index text
Invitation texts
Other information texts

Code base¶

There are now nearly three times as many tests than before covering 78% of the server code.

See the full changelog here

Thanks¶

We sincerely thank NLnet for their support that has made this possible. ❤

Upgrade¶

Instructions to upgrade from versions 2.x.x to 3.0.0

We have tried to keep the upgrade path as simple as possible.

Backup your database and the /uploads directory first.

Install the new code¶

Stop LiberaForms and pull the new code

sudo supervisorctl stop liberaforms

git pull origin main
source venv/bin/activate
pip install --upgrade pip
pip install -r ./requirements.txt

`.env` variables¶

Remove: FLASK_ENV

Add these new variables: FLASK_DEBUG, LOG_LEVEL, LOG_SERVER_PORT

See dotenv.example for an example file.

Upgrade the database¶

Upgrade the database schema to 6f0e2b9e9db3

flask db upgrade

After upgrading you can see your database schema version.

flask site get-versions

Gunicorn¶

This configuration has changed.
Use this command to see the updated version.

flask config hint gunicorn

And edit your gunicorn.py file

Supervisor¶

This configuration has changed. The supervisor now manages processes.

The Gunicorn server
An application log server

You need to update your /etc/supervisor/conf.d/ files.

Use this command to see the updated versions.

flask config hint supervisor

And start the two processes.

sudo supervisorctl start liberaforms
sudo supervisorctl start liberaforms-logs

Debugging¶

We have tested this migration path however, things happen.

If you run into trouble, first try debugging. More info in the docs/INSTALL.md file.