Open Food Facts Contents: Difference between revisions

Revision as of 16:36, 21 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, as described by the issue #7983, using WordPress CMS was the natural candidate, 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 :

Choose a page. Look at openfoodfacts-web Ex: who-we-are
Go to world.openfoodfacts.org/who-we-are, to see how the page is organized
Go to the WordPress admin panel in, Pages > Add New Page
Set the title. And build the page in the editor
Once finished, save and publish
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.
-
-
-
-
-

@@ Line 7: / Line 7: @@
 * The UI is well known by a lot of people
-* Is already used for the [[Blog planning|blog]]
+* It is already used for the [[Blog planning|blog]]
 * It has good support for translation and Crowdin integration
@@ Line 13: / Line 13: @@
 A first experiment to integrate the content of a WordPress page directly into the site was conclusive. ([https://github.com/openfoodfacts/openfoodfacts-server/pull/10596 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 :
+#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]
+#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
+#Set the title. And build the page in the editor [[File:View of the WordPress Gutenberg editor.png|alt=View of the WordPress Gutenberg editor on the the who-we-are page|thumb|189x189px|none]]
+#Once finished, save and publish
+#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. [[File:View of WordPress page menu in quick edit mode .png|alt=View of WordPress page menu, in quick edit mode|none|thumb|172x172px]]
+# -
+# -
+# -
+# -
+# -