Add section for WordPress operations for updating the sidebar to show

the current release version.
This commit is contained in:
Richard England 2022-05-19 16:09:52 -07:00
commit 0ca24c42e3
2 changed files with 99 additions and 2 deletions

View file

@ -35,7 +35,7 @@ This repository contains sources of the [Fedora Magazine documentation](https://
This repo includes scripts to build and preview the contents of this repository.
**NOTE**: Please note that if you reference pages from other repositoreis, such links will be broken in this local preview as it only builds this repository. If you want to rebuild the whole Fedora Docs site, please see [the Fedora Docs build repository](https://pagure.io/fedora-docs/docs-fp-o/) for instructions.
**NOTE**: Please note that if you reference pages from other repositories, such links will be broken in this local preview as it only builds this repository. If you want to rebuild the whole Fedora Docs site, please see [the Fedora Docs build repository](https://pagure.io/fedora-docs/docs-fp-o/) for instructions.
Both scripts work on Fedora (using Podman) and macOS (using Docker).
@ -53,4 +53,4 @@ Fedora Workstation doesn't come with Podman preinstalled by default — so you
```
$ sudo dnf install podman
```
```

View file

@ -58,3 +58,100 @@ In the https://fedoramagazine.org/wp-admin/[WordPress dashboard]:
If you do not know what the name of the series is, you can look in the https://fedoramagazine.org/wp-admin/edit-tags.php?taxonomy=post_series[Post Series] screen.
This is located under the *Posts* section of the left-hand menu.
== Update the current release image/text/link in the Fedora Magazine sidebar
The Fedora Magazine WordPress site contains a column on the right side of the page
that includes several "Widgets". One of these contains the default image (often
the background) for the latest version and links to _getfedora.org_ and the
appropriate release announcement.
The information in this widget must be changed when a new release occurs. This
section describes the process for making the necessary changes.
=== Navigate to the Sidebar Widget
In the https://fedoramagazine.org/[Fedora Magazine Page] select:
. Select: "Fedora Magazine"
+
This is the second item from the left in the menu bar on https://fedoramagazine.org
. Now select the following from the pulldown menu:
+
Appearances > Customize
. Then:
+
Widgets > Sidebar
You are now in the "Customizing Widgets" window.
Each item in this window is shown vertically as it appears in
the right hand sidebar menu on the Fedora magazine page. This starts with
the "Search Fedora Magazine (magnifying glass)" followed by the
currently available Fedora Linux version, subscription option, and so on.
=== Add the feature image for the new Fedora Linux version
Select the currently available image and then select "Add media". The items
in the Media library will be shown. Select the feature image for the
new Fedora linux version announcement from the media library.
There will now be two images appearing.
=== Edit the HTML text
Select the "Text" tab and edit the html that now appears as follows:
. Remove the html <img> tag for the previous version
. Correct the text in "...available now." to reflect the new version number
. Change the "release announcement" link to point to the new release announcement.
==== Text editing example
In this example the changes reflect moving from Fedora 35 to 36.
After adding the second image the text might appear as follows:
....
<img class="alignnone wp-image-36451 size-medium"
src="https://fedoramagazine.org/wp-content/uploads/2022/05/f36-final-300x127.jpg"
alt="" width="300" height="127" />
<img class="alignnone wp-image-36451 size-medium"
src="https://fedoramagazine.org/wp-content/uploads/2021/10/f35-final-300x127.jpg"
alt="" width="300" height="127" />
<a href="https://getfedora.org/"
target="_blank" rel="noopener">Fedora Linux 35 is available now</a>.
Read the <a href="https://fedoramagazine.org/announcing-fedora-35/">
release announcement</a> for all the details.
....
The <img> for f35 should be removed. The first <a> anchor text should be edited to
reflect the new version number (36 in this case). The link to https://getfedora.org
should be left as-is.
The second <a> anchor should be changed to reflect the new Fedora Magazine
announcement URL, for version 36, in this example.
The results should appear similar to the following:
....
<img class="alignnone wp-image-36451 size-medium"
src="https://fedoramagazine.org/wp-content/uploads/2022/05/f36-final-300x127.jpg"
alt="" width="300" height="127" />
<a href="https://getfedora.org/"
target="_blank" rel="noopener">Fedora Linux 36 is available now</a>.
Read the <a href="https://fedoramagazine.org/announcing-fedora-36/">
release announcement</a> for all the details.
....
=== Commit your changes
When done go to the top of the "Customizing > Widget" window and select the
"Publish" button.