moon
/
soapbox
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update customization.md

This commit is contained in:
Curtis 2020-05-28 22:22:22 +00:00
parent e4fe77d56b
commit 13fc6fa530
1 changed files with 31 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
docs/customization.md
View File

@ -11,6 +11,8 @@ Soapbox supports customization of the user interface, to allow per instance bran
* Terms of Service page
* Privacy Policy page
* Copyright Policy page
* Soapbox extensions
* Default settings
## Instance Name
Instance name is edited during the Pleroma installation step or via admin configuration
@ -19,15 +21,18 @@ Instance name is edited during the Pleroma installation step or via admin config
Instance description is edited during the Pleroma installation step or via admin configuration
## Captcha on Registration Page
Use of Captcha on registration page is edited during the Pleroma installation step or via admin configuration
Use of the Captcha feature on the registration page is configured during the Pleroma installation step or via admin configuration
## Site Logo and Promo Panel List Items
The site logo and promo panel list items are customized by copying `soapbox.example.json` in the `static/instance` folder to `soapbox.json`.
The site logo, in SVG format, is rendered to be able to allow the site theme colors to appear in the less than 100% opaque sections of the logo.
The logo colors are rendered in a color that provides contrast for the site theme.
Re-create the webpack and restart the soapbox-fe service to effect the changes.
An example of the contents of `soapbox.example.json`:
The `navlinks` section of the `soapbox.json` file references the links that are displayed at the bottom of the About, Terms of Service, Privacy Policy and Copyright Policy (DMCA) pages.
After editing your HTML files and folder names, re-create the webpack and restart the soapbox-fe service to effect the changes.
Following is an example of the contents of `soapbox.example.json`:
```
{
"logo": "https://media.gleasonator.com/site_uploads/files/000/000/002/original/logo.svg",
@ -47,20 +52,39 @@ An example of the contents of `soapbox.example.json`:
},
"defaultSettings": {
"autoPlayGif": false,
"theme": "lime"
"theme": "azure"
},
"copyright": "?2020. Copying is an act of love. Please copy and share.",
"navlinks": {
"homeFooter": [
{ "title": "About", "url": "/about" },
{ "title": "Terms of Service", "url": "/about/tos" },
{ "title": "Privacy Policy", "url": "/about/privacy" },
{ "title": "DMCA", "url": "/about/dmca" },
{ "title": "Source Code", "url": "/about#opensource" }
]
}
}
```
## Favicon
The favicon is customized by dropping a favicon.png file into the `/static` folder.
Re-create the webpack and restart the soapbox-fe service to effect the changes.
Re-create the webpack and start the soapbox-fe service to effect the changes.
## About Page, Terms of Service Page, Privacy Policy Page and Copyright Policy Page
## About Page, Terms of Service Page, Privacy Policy Page and Copyright Policy (DMCA) Page
These pages are all available for editing in the `static/instance/about.example` folder, as template files, named as:
* index.html
* tos.html
* privacy.html
* dmca.html
The `soapbox.json` file navlinks section's default URL valuess are pointing to the above file location, when the `about.example` folder is renamed to `about`
These four template files have placeholders in them, e.g. "Your_Instance", that should be edited to match your Soapbox instance configuration, and will be meaningless to your users until you edit them.
The pages will not become available resources on your instance until you rename the `static/instance/about.example` folder to `static/instance/about`
These pages will not become available resources on your instance until you rename the `static/instance/about.example` folder to `static/instance/about`, re-create the webpack and start the soapbox-fe service.
## Source Code Link
The Source Code link in the `soapbox.json` file, if used, references a bookmark in the `index.html` file in the `about` folder. The template index.html file has a default bookmark and URL defined in it that you can edit.