Add HOWTO for setting up panel and tos #5

New issue

Open

opened 2020-03-11 14:25:40 +00:00 by mad · 0 comments

mad commented

2020-03-11 14:25:40 +00:00

Member

Feature: Pleroma FE personalize TOS and Panel text
As an administrator of a Pleroma instance
I'd like to change the texts of the side panel and the terms of services
to add specific instance information or a data privacy statement

Implementation

Add the following text somewhere to the documentation:

Adapt Sidepanel text and Terms of Service

First make shure, that your static dir is set right

If you are running the database driven config, adapt it in the Admin Pannel -> Settings -> Instance -> Static dir, e.g. set it to /var/lib/pleroma/static.
If you are running the file based config, set this to your /etc/pleroma/config.exs:

config :pleroma, :instance, static_dir: "/var/lib/pleroma/static"

Check, that this directory exists and has the needed subdirectories:

mkdir -p /var/lib/pleroma/static/instance
mkdir -p /var/lib/pleroma/static/static

Now add html stubs to both files, the panel text and to the terms of service. Here is an example text, with adapted margin. You should later adapt both text files to your needs, first the side panel, which should be the smaller one of both texts and will only show up, if you have the site specific panel switched on in the configuration settings.

Edit /var/lib/pleroma/static/instance/panel.html and add:

<div style="margin:12px;">
<h1>Hello</h1>
<p>This is my Pleroma instance. I do not provide commercial services. See here for <a href="/about">data privacy statement</a>.</p>
</div>

After this edit /var/lib/pleroma/static/static/terms-of-service.html and add:

<div style="margin:12px;">
<h1>Terms of Service</h1>
<p>Here you find my terms of service and below my data privacy statement</p>
<p>yes, you will have to write it. :-)</p>
</div>

This and other information will be shown, if you call your /about page of your site.

Now set the right permissions for all files and directories:

chown -R pleroma:pleroma /var/lib/pleroma/static

Finally you are ready to load your Pleroma Frontend in your Browser. Attention: If you don't see the change immediately when pressing F5, the browser may have cached the files, so you need to flush your browser cahe in the browser settings and reload again.

~~~gherkin Feature: Pleroma FE personalize TOS and Panel text As an administrator of a Pleroma instance I'd like to change the texts of the side panel and the terms of services to add specific instance information or a data privacy statement ~~~ ## Implementation Add the following text somewhere to the documentation: ## Adapt Sidepanel text and Terms of Service First make shure, that your static dir is set right - If you are running the database driven config, adapt it in the Admin Pannel -> Settings -> Instance -> Static dir, e.g. set it to `/var/lib/pleroma/static`. - If you are running the file based config, set this to your `/etc/pleroma/config.exs`: ~~~elixir config :pleroma, :instance, static_dir: "/var/lib/pleroma/static" ~~~ Check, that this directory exists and has the needed subdirectories: ~~~sh mkdir -p /var/lib/pleroma/static/instance mkdir -p /var/lib/pleroma/static/static ~~~ Now add html stubs to both files, the panel text and to the terms of service. Here is an example text, with adapted margin. You should later adapt both text files to your needs, first the side panel, which should be the smaller one of both texts and will only show up, if you have the site specific panel switched on in the configuration settings. Edit /var/lib/pleroma/static/instance/panel.html and add: ~~~html <div style="margin:12px;"> <h1>Hello</h1> <p>This is my Pleroma instance. I do not provide commercial services. See here for <a href="/about">data privacy statement</a>.</p> </div> ~~~ After this edit /var/lib/pleroma/static/static/terms-of-service.html and add: ~~~html <div style="margin:12px;"> <h1>Terms of Service</h1> <p>Here you find my terms of service and below my data privacy statement</p> <p>yes, you will have to write it. :-)</p> </div> ~~~ This and other information will be shown, if you call your `/about` page of your site. Now set the right permissions for all files and directories: ~~~sh chown -R pleroma:pleroma /var/lib/pleroma/static ~~~ Finally you are ready to load your Pleroma Frontend in your Browser. **Attention**: If you don't see the change immediately when pressing F5, the browser may have cached the files, so you need to flush your browser cahe in the browser settings and reload again.