Open Food Facts Contents: Difference between revisions

From Open Food Facts wiki
No edit summary
mNo edit summary
Line 17: Line 17:
We plan to migrate the pages progressively. Here are the steps to follow :
We plan to migrate the pages progressively. Here are the steps to follow :


#Choose a page. Look at [https://github.com/openfoodfacts/openfoodfacts-web/tree/main openfoodfacts-web] Ex: [https://github.com/openfoodfacts/openfoodfacts-web/blob/main/lang/en/texts/who-we-are.html who-we-are]
#Choose a page to work on. Look at [https://github.com/openfoodfacts/openfoodfacts-web/tree/main openfoodfacts-web], for example: [https://github.com/openfoodfacts/openfoodfacts-web/blob/main/lang/en/texts/who-we-are.html who-we-are]
#Go to [[/world.openfoodfacts.org/who-we-are|world.openfoodfacts.org/who-we-are]], to see how the page is organized
#Go to [[/world.openfoodfacts.org/who-we-are|world.openfoodfacts.org/who-we-are]], to see how the page is organized
#Go to the [https://contents.openfoodfacts.org WordPress admin panel] in, Pages > Add New Page
#Go to the [https://contents.openfoodfacts.org WordPress admin panel] in, Pages > Add New Page

Revision as of 09:11, 22 August 2024

This page is about managing multilingual static pages.

CMS migration project

As of today in August 2024, static pages are stored in the openfoodfacts-web Github repository. Adding a new page, setting it up for translation, deploying it, is not an efficient process.

That is why, using WordPress CMS was the natural candidate (see #7983), for the following reason:

  • The UI is well known by a lot of people
  • It is already used for the blog
  • It has good support for translation and Crowdin integration

The ultimate goal is to be able to retrieve the translation of a page, just its content, and incorporate it into the site/app. The challenge is also to render the page as close as possible to how it looks in the WordPress editor.

A first experiment to integrate the content of a WordPress page directly into the site was conclusive. (PR #10596)

How to: replace an Openfoodfacts-web page by a Wordpress page

We plan to migrate the pages progressively. Here are the steps to follow :

  1. Choose a page to work on. Look at openfoodfacts-web, for example: who-we-are
  2. Go to world.openfoodfacts.org/who-we-are, to see how the page is organized
  3. Go to the WordPress admin panel in, Pages > Add New Page
  4. Set the title. And build the page in the editor
    View of the WordPress Gutenberg editor on the the who-we-are page
  5. Once finished, save and publish
  6. The title is different from the original slug who-we-are, go back to the page menu then, on the page > Quick Edit, and change it.
    View of WordPress page menu, in quick edit mode
  7. -
  8. -
  9. -
  10. -
  11. -