WordPress Operations

Adding a new user

Do not add new users manually. User accounts are created on login with Fedora Account System credentials.

User details

We use real names on the Magazine for authors. This reflects accountability for posts on a more official Fedora outlet.

Locate the user in the Users control panel, and select Edit. Switch the default display of the user name to first and last name.

User permissions

We use the User Role Editor plugin to manage user permissions at a fine-grained level. There are five roles in our WordPress instance:

  • Administrator This role has the ability to make settings changes and conduct other administrative tasks.

  • Author This role has the ability to create and edit (unpublished) posts, moderate comments, and upload files. Authors may be granted this role, and should be if they are repeat contributors.

  • Contributor This is the default role. This role has the ability to create and edit (unpublished) posts.

  • Editor This role has many abilites, including the ability ot edit published posts and posts by other authors. Magazine editors should have this role.

  • Subscriber This role only allows for reading posts. We probably don’t need to add anyone to this role in general.

Changing a user’s role

In the WordPress dashboard:

  1. Select Users on the left-hand menu

  2. Search or browse for the desired user

  3. Hover over the desired user’s row and click "Edit"

  4. Change the Role dropdown to the desired role

  5. Click the Update User button

Adding an article to a series

Fedora Magazine uses "series" in WordPress to display related articles in a sidebar. This is often used for Copr articles. However, adding an article to a series is not straightforward. In the WordPress dashboard:

  1. Select Posts on the left-hand menu

  2. Search or browse for the desired posts

  3. Click Quick Edit

  4. In the Post Series box, type the name of the desired series

  5. Click Update

If you do not know what the name of the series is, you can look in the 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 fedoraproject.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 Fedora Magazine Page select:

  1. Select: "Fedora Magazine" + This is the second item from the left in the menu bar on https://fedoramagazine.org

  2. Now select the following from the pulldown menu:

    Appearances > Customize

  3. 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:

  1. Remove the html <img> tag for the previous version

  2. Correct the text in "…​available now." to reflect the new version number

  3. 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://fedoraproject.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://fedoraproject.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://fedoraproject.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.

Want to help? Learn how to contribute to Fedora Docs ›