thomasnares · thomasnares · Oct 27, 2022 · Oct 27, 2022 · Oct 28, 2022 · Oct 28, 2022
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
@@ -4,7 +4,7 @@ Thank you for contributing to the PrestaShop developer documentation!
 Please take the time to edit the "Answers" rows below with the necessary information.
 
 Check out our contribution guidelines on how to contribute:
-https://devdocs.prestashop.com/8/contribute/documentation/how/
+https://devdocs.prestashop-project.org/8/contribute/documentation/how/
 ------------------------------------------------------------------------------>
 
 | Questions     | Answers

diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
@@ -20,7 +20,7 @@ jobs:
       - name: Setup Hugo
         uses: peaceiris/actions-hugo@v2
         with:
-          hugo-version: '0.82.0'
+          hugo-version: '0.85.0'
           extended: true
 
       - name: Find version from branch name (pull request)
@@ -55,4 +55,6 @@ jobs:
           mv _current "src/content/$VERSION"
 
       - name: Build
+        env:
+          DEVDOCS_GITHUB_READ_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: cd src/ && hugo
diff --git a/README.md b/README.md
@@ -3,11 +3,11 @@
 [![Build](https://github.com/PrestaShop/docs/actions/workflows/build.yml/badge.svg)](https://github.com/PrestaShop/docs/actions/workflows/build.yml)
 [![DevDocs Site update](https://github.com/PrestaShop/docs/actions/workflows/update-site.yml/badge.svg)](https://github.com/PrestaShop/docs/actions/workflows/update-site.yml)
 
-This documentation is available at https://devdocs.prestashop.com/
+This documentation is available at [https://devdocs.prestashop-project.org/](https://devdocs.prestashop-project.org/)
 
 ## Contributing
 
-Contributions are more than welcome! [Find out how](https://devdocs.prestashop.com/8/contribute/documentation/how/).
+Contributions are more than welcome! [Find out how](https://devdocs.prestashop-project.org/8/contribute/documentation/how/).
 
 ## Rendering the site locally
 

diff --git a/_index.md b/_index.md
@@ -3,8 +3,9 @@ title: PrestaShop 8 Documentation
 menuTitle: PrestaShop 8
 versionId: "8"            # this should match the physical directory in devdocs-site
 versionGithubPath: "8.x"  # this should match the branch name in github
-versionMeta: Dev        # only one version can be current!
+versionMeta: Current        # only one version can be current!
 chapter: true
+hookListUrl: "/8/modules/concepts/hooks/list-of-hooks"  # this allows for dynamic hook results in algolia's docsearch
 ---
 
 # PrestaShop 8 Documentation

diff --git a/basics/_index.md b/basics/_index.md
@@ -3,6 +3,8 @@ title: Basics
 weight: 1
 pre: "<b>1. </b>"
 chapter: true
+showOnHomepage: true
+icon: fa-play
 ---
 
 ### Chapter 1

diff --git a/basics/deployment/_index.md b/basics/deployment/_index.md
@@ -1,6 +1,7 @@
 ---
 title: Deployment
-weight: 18
+weight: 40
+showOnHomepage: true
 ---
 
 # Deployment

diff --git a/basics/installation/_index.md b/basics/installation/_index.md
@@ -1,6 +1,7 @@
 ---
 title: Installation
-weight: 15
+weight: 20
+showOnHomepage: true
 ---
 
 # Installation

diff --git a/basics/installation/configuration.md b/basics/installation/configuration.md
diff --git a/basics/installation/httpd.md b/basics/installation/httpd.md
@@ -44,20 +44,21 @@ It may be incomplete, and remember you must adapt it for your own server's needs
 ## With PHP-FPM
 
 You first have to ensure you have the `php-fpm` binary and Apache's FastCGI installed.
-On a Debian based, packages are `libapache2-mod-fcgid` and `php7.1-fpm`.
+On a Debian based, packages are `libapache2-mod-fcgid` and `php7.2-fpm`.
 
 After installing these packages, fpm service will automatically be started.
 PHP-FPM uses so-called pools to handle incoming FastCGI requests. 
 
 Here's an example:
+
 ```ini
 ; a pool called www
 [www]
 user = www-data
 group = www-data
 
 ; use a unix domain socket
-listen = /var/run/php/php7.1-fpm.sock
+listen = /var/run/php/php7.2-fpm.sock
 ; or listen on a TCP socket
 ; listen = 127.0.0.1:9000
 
@@ -92,7 +93,7 @@ Don't forget to edit this configuration to make it works.
     # with mod_rewrite or mod_autoindex
     <FilesMatch \.php$>
         # SetHandler proxy:fcgi://127.0.0.1:9000
-        SetHandler proxy:unix:/var/run/php/php7.1-fpm.sock|fcgi://dummy
+        SetHandler proxy:unix:/var/run/php/php7.2-fpm.sock|fcgi://dummy
     </FilesMatch>
 
     DocumentRoot /path/to/prestashop

diff --git a/basics/installation/install-from-cli.md b/basics/installation/install-from-cli.md
@@ -0,0 +1,111 @@
+---
+title: Installing PrestaShop from CLI
+menuTitle: Installation from CLI
+weight: 15
+---
+
+# Installing PrestaShop from CLI
+
+Since version 1.5.4, PrestaShop has a command-line installer.
+
+This special installer makes it possible to install PrestaShop without the need to use a web browser: simply put the content of the zip archive on your web server or pull code from an official PrestaShop repository, and you can install PrestaShop through your command-line interface (CLI). 
+
+{{% notice info %}}
+If deploying from sources (PrestaShop repository), you must first install Composer dependencies.
+Install them with `composer install` from project's root directory.
+{{% /notice %}}
+
+The point of having a CLI installer in addition to the regular in-browser installer is to provide a solution to some advanced users, who often prefer command-line interfaces as they tend to give a more concise and powerful means to control a program or operating system. We can see the advantage of CLI installer in Continuous Integration processes.
+
+## How to use it
+
+To use the CLI installer, use your terminal, go to the `/install` (or `/install-dev`) folder, and start the script with this command:
+
+```shell
+php index_cli.php
+```
+
+This command, by default, will display the various available options:
+
+| Argument        | Description                                | Default value                | Allowed values                                                                                        |
+| :-------------- | :----------------------------------------- | :--------------------------- | :---------------------------------------------------------------------------------------------------- |
+| `step`          | Installation steps to execute              | all                          | all, database, fixtures, theme, modules, postInstall                                                  |
+| `language`      | Language ISO code to install               | en                           | 2 letters ISO 639-1 code ([ISO 639-1][iso-639-1]) with available translation files in `/translations` |
+| `all_languages` | Installs all available languages           | 0                            | 0, 1                                                                                                  |
+| `timezone`      | Set timezone of instance                   | Europe/Paris                 | Valid timezone ([TZ Database][tz-database])                                                           |
+| `base_uri`      | Base URI (appended after domain name)      | /                            | Any URI                                                                                               |
+| `domain`        | Domain name for the shop (without http/s)  | localhost                    | Any domain name or IP address                                                                         |
+| `db_server`     | Database server hostname                   | localhost                    | Any valid MySQL valid server name or IP address                                                       |
+| `db_user`       | Database server user                       | root                         | Any valid MySQL user name                                                                             |
+| `db_password`   | Database server password                   | ""                           | The valid password for `db_user`                                                                      |
+| `db_name`       | Database name                              | prestashop                   | _string_                                                                                              |
+| `db_clear`      | Drop existing tables                       | 1                            | 0, 1                                                                                                  |
+| `db_create`     | Create the database if not exists          | 0                            | 0, 1                                                                                                  |
+| `prefix`        | Prefix of table names                      | ps\_                         | _string_                                                                                              |
+| `engine`        | Engine for MySQL                           | InnoDB                       | InnoDB, MyISAM                                                                                        |
+| `name`          | Name of the shop                           | PrestaShop                   | _string_                                                                                              |
+| `activity`      | Default activity of the shop               | 0                            | Id of an activity ([Complete list of activities][activities])                                         |
+| `country`       | Country of the shop                        | fr                           | 2 letters Alpha-2 code of ISO-3166 list([ISO-3166][iso-3166])                                         |
+| `firstname`     | Admin user firstname                       | John                         | _string_                                                                                              |
+| `lastname`      | Admin user lastname                        | Doe                          | _string_                                                                                              |
+| `password`      | Admin user password                        | Correct Horse Battery Staple | _string_                                                                                              |
+| `email`         | Admin user email                           | pub@prestashop.com           | _string_                                                                                              |
+| `license`       | Show PrestaShop license after installation | 0                            | 0, 1                                                                                                  |
+| `theme`         | Theme name to install                      | "" (classic)                 | Theme name (located in `/themes`)                                                                     |
+| `ssl`           | Enable SSL (from PS 1.7.4)                 | 0                            | 0, 1                                                                                                  |
+| `rewrite`       | Enable rewrite engine                      | 1                            | 0, 1                                                                                                  |
+| `fixtures`      | Install fixtures                           | 1                            | 0, 1                                                                                                  |
+| `modules`       | Modules to install, separated by comma     | [] (all)                     | _array_ of module names (located in `/modules`)                                                       |
+
+- All the options from the regular in-browser installer are available, with their default values listed above.
+- Almost all default option values can be left as is because you can edit them all from the PrestaShop Back Office once the installation is complete. 
+
+{{% notice info %}}
+Note that the e-mail and password are used to create the administrator's Back Office account.
+{{% /notice %}}
+
+To start the installation, we recommend that you provide at least these arguments :
+
+- `domain`. The domain name where your shop will be available.
+- `db_server`. The database server address.
+- `db_name`. The name of the database you want to use. **We strongly recommend that you change the default `prestashop` value**
+- `db_user`. The username for the database you want to use.
+- `db_password`. The password for the database username above.
+- `prefix`. **We strongly recommend that you change the default `ps_` value.**
+- `email`. Your email to connect to the Back Office. 
+- `password`. The password to connect to the Back Office.
+
+Example:
+
+```shell
+php index_cli.php 
+    --domain=example.com 
+    --db_server=sql.example.com 
+    --db_name=myshop
+    --db_user=root 
+    --db_password=123456789 
+    --prefix=myshop_
+    --email=me@example.com
+    --password=mystrongpassword
+```
+
+If the installation completes without any errors, you should see the following confirmation:
+
+```shell
+-- Installation successful! --
+```
+
+{{% notice info %}}
+Before running this command, please note that your database must be created with a `CREATE DATABASE xxx;` statement. 
+If the database is not created, please use argument `--db_create=1` to create the database.
+{{% /notice %}}
+
+{{% notice info %}}
+If your MySQL server is configured on a different port than `3306`, please specify it in the `db_server` argument like this :
+`--db_server=sql.example.com:3307`
+{{% /notice %}}
+
+[iso-639-1]: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
+[tz-database]: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+[activities]: https://github.com/PrestaShop/PrestaShop/blob/8.0.x/src/PrestaShopBundle/Form/Admin/Configure/ShopParameters/General/PreferencesType.php#L211-L230
+[iso-3166]: https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes