Differences between revisions 2 and 7 (spanning 5 versions)
Revision 2 as of 2021-08-06 01:08:38
Size: 6346
Comment: Minor tweak to image name
Revision 7 as of 2022-05-31 10:10:35
Size: 7660
Editor: ?BenedekNagy
Comment: wordpress app: add description for the upcoming update
Deletions are marked like this. Additions are marked like this.
Line 4: Line 4:
[[FreedomBox/Manual/MatrixSynapse|English]] - [[DebianWiki/EditorGuide#translation|(+)]] -~ ~- [[FreedomBox/Manual/WordPress|English]] - [[es/FreedomBox/Manual/WordPress|Español]] - [[DebianWiki/EditorGuide#translation|(+)]] -~
Line 19: Line 19:
{{attachment:wordpress-site.png|A Simple Site}}

{{attachment:wordpress-edit.png|Content Editing Interface}}

{{attachment:wordpress-admin.png|Administration Interface}}
Line 21: Line 27:
To setup !WordPress, navigate to the !WordPress (Website and Blog) page and install it. !WordPress needs a valid domain name to be configured. Before proceeding further, setup a proper domain name. Domains are configured using [[FreedomBox/Manual/Configure|System -> Configure]] page. Access your !FreedomBox web interface using the domain you have configured. After this, visit the !WordPress web interface. This will show a setup page asking for the name of the site and details for a new administrator account. After this step, !WordPress if fully configured and ready. You can then return to the !FreedomBox's !WordPress app page and optionally make the !WordPress installation available to public. To setup !WordPress, navigate to the !WordPress (Website and Blog) page and install it. !WordPress needs a valid domain name to be configured. Before proceeding further, setup a proper domain name. Domains are configured using [[FreedomBox/Manual/Configure|System -> Configure]] page. Access your !FreedomBox web interface using the domain you have configured. After this, visit the !WordPress web interface. This will show a setup page asking for the name of the site and details for a new administrator account. After this step, !WordPress is fully configured and ready. You can then return to the !FreedomBox's !WordPress app page and optionally make the !WordPress installation available to public.

{{attachment:wordpress-setup.png|Initial Setup Page}}
Line 35: Line 43:
A beautiful, well customized !WordPress website can be set as the home page for your !FreedomBox. This can be done in [[FreedomBox/Manual/Configure|System -> Configure]] page of !FreedomBox inteface. For example, if your !FreedomBox's domain name is myfreedombox.rocks and you set !WordPress as the home page, visiting https://myfreedombox.rocks will take you to https://myfreedombox.rocks/wordpress/ instead of the !FreedomBox interface. A beautiful, well customized !WordPress website can be set as the home page for your !FreedomBox. This can be done in [[FreedomBox/Manual/Configure|System -> Configure]] page of the !FreedomBox web interface. For example, if your !FreedomBox's domain name is myfreedombox.rocks and you set !WordPress as the home page, visiting https://myfreedombox.rocks will take you to https://myfreedombox.rocks/wordpress/ instead of the !FreedomBox interface.
Line 39: Line 47:
When !WordPress is setup for the first time, the domain name through which you access it is noted and !WordPress gets configured with that domain name. Be sure to setup your domain name properly and access the !WordPress setup process using the domain name and not a local IP address or domain name. Currently, !FreedomBox does not provide an easy way to change the domain name ones the app is installed. When !WordPress is setup for the first time, the domain name through which you access it is noted and !WordPress gets configured with that domain name. Be sure to setup your domain name properly and access the !WordPress setup process using the domain name and not a local IP address or domain name. Currently, !FreedomBox does not provide an easy way to change the domain name once the app is installed.
Line 44: Line 52:

{{attachment:wordpress-permalinks.png|Enabling Permalinks}}
Line 51: Line 61:
!WordPress in itself is quite powerful and sufficient to create and manage a simple website or blog. It's true power, however, lies in the thousands of plugins and themes. Plugins extend the functionality of the !WordPress. For example, a contact form can be added to !WordPress by installing the appropriate plugin. Themes change the appearance and layout of the site. Installing a new theme will provides an extra administration option for how your site will appear to your visitors. !WordPress in itself is quite powerful and sufficient to create and manage a simple website or blog. It's true power, however, lies in the thousands of plugins and themes. Plugins extend the functionality of !WordPress. For example, a contact form can be added to !WordPress by installing the appropriate plugin. Themes change the appearance and layout of the site. Installing a new theme will provide an extra administration option for how your site will appear to your visitors.

From !FreedomBox version '''22.13''', you can install plugins and themes directly from the !WordPress GUI.

==== Google Fonts Privacy Issue ====
Please be aware that many of the third-party themes use [[https://en.wikipedia.org/wiki/Google_Fonts|Google Fonts]] which will violate your visitors' privacy.

One way to remove Google Fonts from your !WordPress site is to remove the respective code lines from your theme's source code under '''Appearance''' >> '''Theme Editor'''. Please note these changes may be overwritten by the theme's next update.

==== Failing Updates ====

Manual update of the default theme and plugin, namely '''Twenty Twenty-One''' and '''Akismet Anti-Spam''' will fail, since these updates are managed separately by Debian. You do not have to worry about their updating.

==== Note for FreedomBox between version 21.7 and 22.12 ====
Line 55: Line 78:
 * Note the URL of the plugin or theme to download by browsing them from !WordPress interface or official website. Be sure to select trustworthy ones with a free software license.
 * Log in via SSH using a !FreedomBox administrator account.
 * Download the plugin or theme and unpack into a directory them using the command line.
 * Move the directory under '''/var/lib/wordpress/wp-content/plugins/''' or '''/var/lib/wordpress/wp-content/themes/'''.
 * Watch for upgrades to these plugins from !WordPress and repeat the process for installing newer versions.
 1. Note the URL of the plugin or theme to download by browsing them from !WordPress administration interface or the official website. Be sure to select trustworthy ones with a free software license.
 1. Log in via SSH using a !FreedomBox administrator account.
 1. Download the plugin or theme and unpack into a directory using the command line.
 1. Move the directory under '''/var/lib/wordpress/wp-content/plugins/''' or '''/var/lib/wordpress/wp-content/themes/''' as appropriate.
 1. Watch for upgrades to these plugins from !WordPress and repeat the process for installing newer versions.
Line 67: Line 90:
 * Google Fonts: https://en.wikipedia.org/wiki/Google_Fonts

English - Español - (+)

WordPress (Website and Blog)

WordPress icon

Available since: version 21.7

What is WordPress?

WordPress is a popular way to create and manage websites and blogs. It is a content management system that allows editing content using a visual web-based interface. No knowledge of HTML or other markup is needed to create websites. Complete layout and functionality of the web pages can be customized. Appearance can be chosen using themes. Administration interface and produced web pages are suitable for mobile devices.

A Simple Site

Content Editing Interface

Administration Interface

Setting up WordPress on FreedomBox

To setup WordPress, navigate to the WordPress (Website and Blog) page and install it. WordPress needs a valid domain name to be configured. Before proceeding further, setup a proper domain name. Domains are configured using System -> Configure page. Access your FreedomBox web interface using the domain you have configured. After this, visit the WordPress web interface. This will show a setup page asking for the name of the site and details for a new administrator account. After this step, WordPress is fully configured and ready. You can then return to the FreedomBox's WordPress app page and optionally make the WordPress installation available to public.

Initial Setup Page

Public Access

In the WordPress app page in FreedomBox, the app can be made publicly available. It is, by default, not publicly available. It is only available to users who login as administrators in FreedomBox interface. This is to protect the initial setup process from becoming publicly available. If the setup process is publicly available, any visitor will be able to create themselves an administrator account which is undesirable. Administrators must take care not to enable public access until WordPress' setup process has been completed.

Users

At the moment, WordPress has its own user accounts that are unrelated to FreedomBox accounts. The first account created during the setup process is an administrator account. After logging in with the administrator account, separate accounts for viewing, publishing, or administering may be created from within WordPress interface.

Changes to content and configuration of WordPress can only be done after logging into WordPress. However, by default, there is no link from the website or blog to reach the login page. Bookmark or directly type into the browser https://<mydomainname>/wordpress/wp-admin/ to reach administration interface.

WordPress as Home Page

A beautiful, well customized WordPress website can be set as the home page for your FreedomBox. This can be done in System -> Configure page of the FreedomBox web interface. For example, if your FreedomBox's domain name is myfreedombox.rocks and you set WordPress as the home page, visiting https://myfreedombox.rocks will take you to https://myfreedombox.rocks/wordpress/ instead of the FreedomBox interface.

Domain Name

When WordPress is setup for the first time, the domain name through which you access it is noted and WordPress gets configured with that domain name. Be sure to setup your domain name properly and access the WordPress setup process using the domain name and not a local IP address or domain name. Currently, FreedomBox does not provide an easy way to change the domain name once the app is installed.

By default, web addresses for newly created blog posts and pages look like /wordpress/?p=1. They can be made to look prettier like /wordpress/2021/08/06/sample-post/ instead. This can be done from the Settings -> Permalinks configuration page in WordPress interface. The necessary web server configuration changes are handled by FreedomBox during app installation.

Enabling Permalinks

Automatic Upgrades

Similar to all other apps, feature and security upgrades for WordPress are automatically handled by FreedomBox (when not disabled). After a minor version upgrade, changes to the database structure are automatically done by WordPress. However, after a major version upgrade, such as during major distribution upgrade every two years, database changes are not done automatically. For this, you need to login to WordPress and trigger the changes manually.

Plugins and Themes

WordPress in itself is quite powerful and sufficient to create and manage a simple website or blog. It's true power, however, lies in the thousands of plugins and themes. Plugins extend the functionality of WordPress. For example, a contact form can be added to WordPress by installing the appropriate plugin. Themes change the appearance and layout of the site. Installing a new theme will provide an extra administration option for how your site will appear to your visitors.

From FreedomBox version 22.13, you can install plugins and themes directly from the WordPress GUI.

Google Fonts Privacy Issue

Please be aware that many of the third-party themes use Google Fonts which will violate your visitors' privacy.

One way to remove Google Fonts from your WordPress site is to remove the respective code lines from your theme's source code under Appearance >> Theme Editor. Please note these changes may be overwritten by the theme's next update.

Failing Updates

Manual update of the default theme and plugin, namely Twenty Twenty-One and Akismet Anti-Spam will fail, since these updates are managed separately by Debian. You do not have to worry about their updating.

Note for FreedomBox between version 21.7 and 22.12

Since there are few plugins/themes packaged for Debian, FreedomBox does not provide a simple way to install and manage them. You need to install them manually. This can be done as follows:

  1. Note the URL of the plugin or theme to download by browsing them from WordPress administration interface or the official website. Be sure to select trustworthy ones with a free software license.

  2. Log in via SSH using a FreedomBox administrator account.

  3. Download the plugin or theme and unpack into a directory using the command line.
  4. Move the directory under /var/lib/wordpress/wp-content/plugins/ or /var/lib/wordpress/wp-content/themes/ as appropriate.

  5. Watch for upgrades to these plugins from WordPress and repeat the process for installing newer versions.

Back to Features introduction or manual pages.


Intro

Information

Support

Contribute

Reports

Promote

Vision

Hardware

Live Help

Where To Start

Translate

Calls

Talks

Overview

Download

Q&A

To Do

Design

Releases

Press

Features

Manual

Contributors

Code

Blog

FreedomBox for Communities

FreedomBox Developer Manual

HELP & DISCUSSIONS: Discussion Forum - Matrix - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project

Next call: Saturday, April 13 at 14:00 UTC

This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.


CategoryFreedomBox