From 0ca24c42e375ffee8f05411d8034ff1fdcd67168 Mon Sep 17 00:00:00 2001 From: Richard England Date: May 19 2022 23:09:52 +0000 Subject: Add section for WordPress operations for updating the sidebar to show the current release version. --- diff --git a/README.md b/README.md index 48aac47..7ed658b 100644 --- a/README.md +++ b/README.md @@ -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 -``` \ No newline at end of file +``` diff --git a/modules/ROOT/pages/technical-wordpress.adoc b/modules/ROOT/pages/technical-wordpress.adoc index a34072c..074f844 100644 --- a/modules/ROOT/pages/technical-wordpress.adoc +++ b/modules/ROOT/pages/technical-wordpress.adoc @@ -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 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: + +.... + + + + + Fedora Linux 35 is available now. + Read the + release announcement for all the details. +.... + +The for f35 should be removed. The first 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 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: + +.... + + + Fedora Linux 36 is available now. + Read the + release announcement for all the details. +.... + +=== Commit your changes + +When done go to the top of the "Customizing > Widget" window and select the +"Publish" button.