add doc

README.md

@@ -5,6 +5,8 @@
 
 ## Opentalent extensions for Typo3
 
+Pour plus d'informations: [consulter la documentation](/doc)
+
 ### Pré-requis:
 
 * php 7.4
@@ -16,8 +18,7 @@ Pour plus d'information sur chaque extension, consultez les readme de chacune d'
 
 ### Pour les installer
 
-1. Copier les répertoires des extensions dans le sous-répertoire `public/typo3conf/ext/` 
-du répertoire de l'application typo3
+1. Copier les répertoires des extensions dans le sous-répertoire `public/typo3conf/ext/` du répertoire de l'application typo3
 2. Ajouter les lignes suivantes au fichier `composer.json` de l'application :
 
     	"autoload": {

doc/be_users.md

@@ -0,0 +1,183 @@
+# Backend users
+ 
+> Voir les spécifications: https://ressources.opentalent.fr/display/SPEC/Droits+typo3
+
+## Users et groupes
+
+Le super admin est l'utilisateur 'oaos', réservé à un usage interne.
+
+Pour chaque site Typo3, il doit exister **un seul** compte admin (admin<subdomain>), et **un seul** groupe d'editeurs (edit<subdomain>), où <subdomain> est le sous-domaine du site.
+
+Les droits des beusers varient selon le produit acheté par l'organisation.
+
+
+## Droits des backend users sur les sites
+
+Ce paragraphe présente les droits des be_users sur les pages et contenus du site: création, édition, suppression...
+
+
+| Autorisations disponibles sur les pages | Code |
+| --- | --- |
+| Show | Afficher/Copier la page et le contenu | 1 |
+| Edit content | Modifier/Ajouter/Supprimer/Déplacer le contenu | 16 |
+| Edit page | Modifier la page, par ex. changer le titre de la page, etc | 2 |
+| Delete | Supprimer/déplacer la page et le contenu | 4 |
+| New | Créer de nouvelles pages sous cette page | 8 |
+
+> Les valeurs de N1 et N2 sont calculées en additionnant les valeurs suivantes: show (1), edit content (16), edit page (2), 
+> delete (4), add (8)
+
+### Licence Premium
+
+#### Admin Premium
+
+| Page | Show | Edit content | Edit page | Delete | New  | Code |
+| --- | --- | --- | --- | --- | ---  | --- |
+| Home | ![v](images/v.svg) | ![v](images/v.svg) | ![v](images/v.svg) | ![x](images/x.svg) | ![v](images/v.svg) | *27* |
+| footer/* (mentions légales, contact, plan du site) | ![v](images/v.svg) | ![x](images/x.svg) | ![x](images/x.svg) | ![x](images/x.svg) | ![v](images/v.svg) | *9* |
+| Adhérents, membres du CA, évènements, évènements des structures, structures adhérentes | ![v](images/v.svg) | ![x](images/x.svg) | ![v](images/v.svg) | ![x](images/x.svg) | ![v](images/v.svg) | *11* |
+| Autres pages | ![v](images/v.svg) | ![v](images/v.svg) | ![v](images/v.svg) | ![v](images/v.svg) | ![v](images/v.svg) | *31* |
+
+#### Editeur Premium
+
+| Page | Show | Edit content | Edit page | Delete | New  | Code |
+| --- | --- | --- | --- | --- | ---  | --- |
+| Home | ![v](images/v.svg) | ![v](images/v.svg) | ![x](images/x.svg) | ![x](images/x.svg) | ![x](images/x.svg) | *17* |
+| footer/* (mentions légales, contact, plan du site) | ![v](images/v.svg) | ![x](images/x.svg) | ![x](images/x.svg) | ![x](images/x.svg) | ![x](images/x.svg) | *1* |
+| Adhérents, membres du CA, évènements, évènements des structures, structures adhérentes | ![v](images/v.svg) | ![x](images/x.svg) | ![x](images/x.svg) | ![x](images/x.svg) | ![x](images/x.svg) | *1* |
+| Autres pages | ![v](images/v.svg) | ![v](images/v.svg) | ![v](images/v.svg) | ![x](images/x.svg) | ![v](images/v.svg) | *27* |
+
+
+
+### Licence Standard
+
+#### Admin Standard
+
+| Page | Show | Edit content | Edit page | Delete | New  | Code |
+| --- | --- | --- | --- | --- | ---  | --- |
+| Home | ![v](images/v.svg) | ![v](images/v.svg) | ![v](images/v.svg) | ![x](images/x.svg) | ![x](images/x.svg) | *19* |
+| footer/* (mentions légales, contact, plan du site) | ![v](images/v.svg) | ![x](images/x.svg) | ![x](images/x.svg) | ![x](images/x.svg) | ![x](images/x.svg) | *1* |
+| Adhérents, membres du CA, évènements, évènements des structures, structures adhérentes | ![v](images/v.svg) | ![x](images/x.svg) | ![x](images/x.svg) | ![x](images/x.svg) | ![x](images/x.svg) | *1* |
+| Autres pages | ![v](images/v.svg) | ![v](images/v.svg) | ![v](images/v.svg) | ![x](images/x.svg) | ![v](images/v.svg) | *27* |
+
+#### Editeur Standard
+
+| Page | Show | Edit content | Edit page | Delete | New  | Code |
+| --- | --- | --- | --- | --- | ---  | --- |
+| Home | ![v](images/v.svg) | ![v](images/v.svg) | ![x](images/x.svg) | ![x](images/x.svg) | ![x](images/x.svg) | *17* |
+| footer/* (mentions légales, contact, plan du site) | ![v](images/v.svg) | ![x](images/x.svg) | ![x](images/x.svg) | ![x](images/x.svg) | ![x](images/x.svg) | *1* |
+| Adhérents, membres du CA, évènements, évènements des structures, structures adhérentes | ![v](images/v.svg) | ![x](images/x.svg) | ![x](images/x.svg) | ![x](images/x.svg) | ![x](images/x.svg) | *1* |
+| Autres pages | ![v](images/v.svg) | ![v](images/v.svg) | ![v](images/v.svg) | ![x](images/x.svg) | ![x](images/x.svg) | *19* |
+
+
+## Accès aux menus
+
+Ce paragraphe présente les menus du backend disponibles selon le type de compte.
+
+| Page | Admin Premium | Editor Premium |   | Admin Standard | Editor Standard |
+| --- | --- | --- | --- | --- | --- |
+| Web - Page | ![v](images/v.svg) | ![v](images/v.svg) |   | ![v](images/v.svg) | ![v](images/v.svg) |
+| Web - Liste | ![v](images/v.svg) | ![x](images/x.svg) |   | ![x](images/x.svg) | ![x](images/x.svg) |
+| Web - Formulaires | ![v](images/v.svg) | ![v](images/v.svg) |   | ![v](images/v.svg) | ![v](images/v.svg) |
+| Web - Corbeille | ![x](images/x.svg) | ![x](images/x.svg) |   | ![x](images/x.svg) | ![x](images/x.svg) |
+| Web - Info | ![x](images/x.svg) | ![x](images/x.svg) |   | ![x](images/x.svg) | ![x](images/x.svg) |
+| Web - Personnaliser | ![v](images/v.svg) | ![x](images/x.svg) |   | ![v](images/v.svg) | ![x](images/x.svg) |
+| Web - Statistiques | ![v](images/v.svg) | ![x](images/x.svg) |   | ![v](images/v.svg) | ![x](images/x.svg) |
+| Web - Gestion des actualités  |  ![v](images/v.svg) | ![v](images/v.svg) |   | ![v](images/v.svg) | ![v](images/v.svg) |
+| Gestionnaire de site - Redirects | ![x](images/x.svg) | ![x](images/x.svg) |   | ![x](images/x.svg) | ![x](images/x.svg) |
+| Fichier - Fichiers | ![v](images/v.svg) | ![x](images/x.svg) |   | ![v](images/v.svg) | ![x](images/x.svg) |
+| Outils Utilisateur - Configuration utilisateur | ![x](images/x.svg) | ![x](images/x.svg) |   | ![x](images/x.svg) | ![x](images/x.svg) |
+| Aide - A propos de... | ![x](images/x.svg) | ![x](images/x.svg) |   | ![x](images/x.svg) | ![x](images/x.svg) |
+| Aide -Manuel TYPO3 | ![x](images/x.svg) | ![x](images/x.svg) |   | ![x](images/x.svg) | ![x](images/x.svg) |
+
+
+## Mise en oeuvre
+
+### Principe de mise en oeuvre
+
+Pour un site 'mywebsite', on va créer un beuser admin et un groupe dédié. Au départ, l'admin est le seul membre de ce groupe, 
+mais d'autres users (les éditeurs) pourront y être ajoutés par la suite.
+
+Ce groupe permet de contrôler les droits de base sur les pages du site (créer, éditer...), droits qui sont communs à l'administrateur et aux éditeurs.  
+L'admin reçoit, en tant que propriétaire des pages du site, des droits d'accès supplémentaires (comme la suppression)
+
+Ce groupe est lui même un sous-groupe du groupe 'EditorStandard' ou 'EditorPremium', selon le produit acheté par la structure.
+Enfin, les admins sont aussi membres du groupe 'AdminStandard' ou 'AdminPremium', qui leur donnent accès aux modules réservés à l'administration (ex: 'Personnaliser')
+
+![schema](images/schema_droits_beusers.svg)
+
+
+### Nouveau client
+
+A la création d'un site dont le sous domaine serait "mysite", on procède ainsi:
+
+1. Créer un groupe 'edit_mysite'
+1. Créer un be_user 'admin_mysite'
+1. Ajouter le be_user 'admin_mysite' au groupe 'edit_mysite'
+1. Ajouter le be_user 'admin_mysite' au groupe 'AdminStandard' ou 'AdminPremium' (selon le produit)
+1. Ajouter le groupe 'edit_mysite' au groupe WriterBasic ou WriterFull, selon la nature du produit
+
+
+
+On attribue ensuite les droits en mettant à jour les champs suivants:
+
+| perms_userid | perms_groupid | perms_user | perms_group | perms_everybody |
+| --- | --- | --- | --- | --- |
+| uid de admin_mysite | uid de edit_mysite | N1* | N2* | 0 |
+
+
+> Toutes ces opérations sont automatisées et peuvent être exécutées via la commande:
+>
+>    `php /var/www/typo3/vendor/bin/typo3 ot:site:reset-perms --create <organization-id>`
+
+
+### La structure change de produit
+
+Pour mettre à jour les droits des be_users , par exemple après un changement de produit:
+
+1. On met à jour les droits sur les pages de 'admin_mysite' et 'edit_mysite' (cf paragraphe précédent) avec la commande ot:site:reset-perms
+1. On retire le groupe 'edit_mysite' de son groupe actuel
+1. On ajoute le groupe 'edit_mysite' au groupe Editor Standard ou Editor Premium, selon la nature du produit
+
+> Toutes ces opérations sont automatisées et peuvent être exécutées via la commande:
+>
+>    `php /var/www/typo3/vendor/bin/typo3 ot:site:reset-perms --create <organization-id>`
+
+
+### Si on veut changer les droits associés aux produits
+
+#### Droits issus des groupes de base
+
+Si les droits à modifier sont hérités d'un des groupes de base (Admin Premium, Editor Premium, Admin Standard, 
+Editor Standard, alors il suffit de modifier le ou les groupes concernés.
+
+
+#### Droits d'accès aux pages
+
+Pour modifier les droits sur les pages, on fera d'abord évoluer la commande la commande ot:site:reset-perms, puis on l'exécute sur tous les sites avec l'option '–all'
+
+    php /var/www/typo3/vendor/bin/typo3 ot:site:reset-perms --all --create
+
+> (L'opération peut prendre quelques minutes)
+
+### Pour ajouter un utilisateur de type éditeur
+
+On créé le be_user correspondant, et on l'affecte au groupe edit_mysite.
+
+
+###  L'administrateur ou un des éditeurs a été modifié dans le logiciel
+
+On déclenche une update des données des be_users via la commande
+
+    php /var/www/typo3/vendor/bin/typo3 ot:site:reset-perms <organization-id>
+
+Ou en effectuant une requête HTTP à l'adresse:
+
+    GET https://preprod.opentalent.fr/typo3/index.php?route=/otadmin/site/reset-perms&organization-id=<organization-id>
+
+ 
+
+ 
+
+ 
+

doc/forms.md

@@ -0,0 +1,8 @@
+# Formulaires
+
+La gestion des formulaires est assurée par l'intermédiaire de l'extension native 'Forms'.
+
+Tous les sites ont un accès en lecture seule au formulaire Contact, qui est défini au sein de l'extension ot_templating.
+
+Chaque site possède ensuite un répertoire dédié: `/var/www/typo3/public/fileadmin/form_definitions/<organization-id>/` 
+dans lequel les définitions des formulaires (fichiers en .form.yaml) créés par le beuser sont enregistrés.

doc/images/schema_droits_beusers.svg

@@ -0,0 +1,198 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.2" width="297mm" height="210mm" viewBox="0 0 29700 21000" preserveAspectRatio="xMidYMid" fill-rule="evenodd" stroke-width="28.222" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" xmlns:ooo="http://xml.openoffice.org/svg/export" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:presentation="http://sun.com/xmlns/staroffice/presentation" xmlns:smil="http://www.w3.org/2001/SMIL20/" xmlns:anim="urn:oasis:names:tc:opendocument:xmlns:animation:1.0" xml:space="preserve">
+ <defs class="ClipPathGroup">
+  <clipPath id="presentation_clip_path" clipPathUnits="userSpaceOnUse">
+   <rect x="0" y="0" width="29700" height="21000"/>
+  </clipPath>
+  <clipPath id="presentation_clip_path_shrink" clipPathUnits="userSpaceOnUse">
+   <rect x="29" y="21" width="29641" height="20958"/>
+  </clipPath>
+ </defs>
+ <defs>
+  <font id="EmbeddedFont_1" horiz-adv-x="2048">
+   <font-face font-family="Liberation Sans embedded" units-per-em="2048" font-weight="normal" font-style="normal" ascent="1852" descent="423"/>
+   <missing-glyph horiz-adv-x="2048" d="M 0,0 L 2047,0 2047,2047 0,2047 0,0 Z"/>
+   <glyph unicode="’" horiz-adv-x="239" d="M 328,1264 C 328,1194 322,1135 309,1088 296,1040 277,995 250,952 L 127,952 C 190,1043 221,1129 221,1212 L 133,1212 133,1409 328,1409 328,1264 Z"/>
+   <glyph unicode="é" horiz-adv-x="980" d="M 276,503 C 276,379 302,283 353,216 404,149 479,115 578,115 656,115 719,131 766,162 813,193 844,233 861,281 L 1019,236 C 954,65 807,-20 578,-20 418,-20 296,28 213,123 129,218 87,360 87,548 87,727 129,864 213,959 296,1054 416,1102 571,1102 889,1102 1048,910 1048,527 L 1048,503 276,503 Z M 862,641 C 852,755 823,838 775,891 727,943 658,969 568,969 481,969 412,940 361,882 310,823 282,743 278,641 L 862,641 Z M 440,1201 L 440,1221 657,1508 864,1508 864,1479 534,1201 440,1201 Z"/>
+   <glyph unicode="è" horiz-adv-x="980" d="M 276,503 C 276,379 302,283 353,216 404,149 479,115 578,115 656,115 719,131 766,162 813,193 844,233 861,281 L 1019,236 C 954,65 807,-20 578,-20 418,-20 296,28 213,123 129,218 87,360 87,548 87,727 129,864 213,959 296,1054 416,1102 571,1102 889,1102 1048,910 1048,527 L 1048,503 276,503 Z M 862,641 C 852,755 823,838 775,891 727,943 658,969 568,969 481,969 412,940 361,882 310,823 282,743 278,641 L 862,641 Z M 657,1201 L 327,1479 327,1508 534,1508 751,1221 751,1201 657,1201 Z"/>
+   <glyph unicode="y" horiz-adv-x="1033" d="M 191,-425 C 142,-425 100,-421 67,-414 L 67,-279 C 92,-283 120,-285 151,-285 263,-285 352,-203 417,-38 L 434,5 5,1082 197,1082 425,484 C 428,475 432,464 437,451 442,438 457,394 482,320 507,246 521,205 523,196 L 593,393 830,1082 1020,1082 604,0 C 559,-115 518,-201 479,-258 440,-314 398,-356 351,-384 304,-411 250,-425 191,-425 Z"/>
+   <glyph unicode="x" horiz-adv-x="1006" d="M 801,0 L 510,444 217,0 23,0 408,556 41,1082 240,1082 510,661 778,1082 979,1082 612,558 1002,0 801,0 Z"/>
+   <glyph unicode="u" horiz-adv-x="874" d="M 314,1082 L 314,396 C 314,325 321,269 335,230 349,191 371,162 402,145 433,128 478,119 537,119 624,119 692,149 742,208 792,267 817,350 817,455 L 817,1082 997,1082 997,231 C 997,105 999,28 1003,0 L 833,0 C 832,3 832,12 831,27 830,42 830,59 829,78 828,97 826,132 825,185 L 822,185 C 781,110 733,58 679,27 624,-4 557,-20 476,-20 357,-20 271,10 216,69 161,128 133,225 133,361 L 133,1082 314,1082 Z"/>
+   <glyph unicode="t" horiz-adv-x="531" d="M 554,8 C 495,-8 434,-16 372,-16 228,-16 156,66 156,229 L 156,951 31,951 31,1082 163,1082 216,1324 336,1324 336,1082 536,1082 536,951 336,951 336,268 C 336,216 345,180 362,159 379,138 408,127 450,127 474,127 509,132 554,141 L 554,8 Z"/>
+   <glyph unicode="s" horiz-adv-x="901" d="M 950,299 C 950,197 912,118 835,63 758,8 650,-20 511,-20 376,-20 273,2 200,47 127,91 79,160 57,254 L 216,285 C 231,227 263,185 311,158 359,131 426,117 511,117 602,117 669,131 712,159 754,187 775,229 775,285 775,328 760,362 731,389 702,416 654,438 589,455 L 460,489 C 357,516 283,542 240,568 196,593 162,624 137,661 112,698 100,743 100,796 100,895 135,970 206,1022 276,1073 378,1099 513,1099 632,1099 727,1078 798,1036 868,994 912,927 931,834 L 769,814 C 759,862 732,899 689,925 645,950 586,963 513,963 432,963 372,951 333,926 294,901 275,864 275,814 275,783 283,758 299,738 315,718 339,701 370,687 401,673 467,654 568,629 663,605 732,583 774,563 816,542 849,520 874,495 898,470 917,442 930,410 943,377 950,340 950,299 Z"/>
+   <glyph unicode="r" horiz-adv-x="530" d="M 142,0 L 142,830 C 142,906 140,990 136,1082 L 306,1082 C 311,959 314,886 314,861 L 318,861 C 347,954 380,1017 417,1051 454,1085 507,1102 575,1102 599,1102 623,1099 648,1092 L 648,927 C 624,934 592,937 552,937 477,937 420,905 381,841 342,776 322,684 322,564 L 322,0 142,0 Z"/>
+   <glyph unicode="q" horiz-adv-x="927" d="M 484,-20 C 347,-20 246,26 182,119 118,212 86,351 86,536 86,913 219,1102 484,1102 566,1102 634,1088 687,1059 740,1030 785,981 821,914 L 823,914 C 823,934 824,969 827,1018 830,1067 832,1093 835,1096 L 1008,1096 C 1003,1057 1001,958 1001,801 L 1001,-425 821,-425 821,14 825,178 823,178 C 787,107 743,56 690,26 637,-5 569,-20 484,-20 Z M 821,554 C 821,695 798,799 752,867 706,935 633,969 532,969 441,969 375,935 335,867 295,799 275,691 275,542 275,391 295,282 336,217 376,152 441,119 530,119 632,119 706,155 752,228 798,301 821,409 821,554 Z"/>
+   <glyph unicode="p" horiz-adv-x="953" d="M 1053,546 C 1053,169 920,-20 655,-20 488,-20 376,43 319,168 L 314,168 C 317,163 318,106 318,-2 L 318,-425 138,-425 138,861 C 138,972 136,1046 132,1082 L 306,1082 C 307,1079 308,1070 309,1054 310,1037 312,1012 314,978 315,944 316,921 316,908 L 320,908 C 352,975 394,1024 447,1055 500,1086 569,1101 655,1101 788,1101 888,1056 954,967 1020,878 1053,737 1053,546 Z M 864,542 C 864,693 844,800 803,865 762,930 698,962 609,962 538,962 482,947 442,917 401,887 371,840 350,777 329,713 318,630 318,528 318,386 341,281 386,214 431,147 505,113 607,113 696,113 762,146 803,212 844,277 864,387 864,542 Z"/>
+   <glyph unicode="o" horiz-adv-x="980" d="M 1053,542 C 1053,353 1011,212 928,119 845,26 724,-20 565,-20 407,-20 288,28 207,125 126,221 86,360 86,542 86,915 248,1102 571,1102 736,1102 858,1057 936,966 1014,875 1053,733 1053,542 Z M 864,542 C 864,691 842,800 798,868 753,935 679,969 574,969 469,969 393,935 346,866 299,797 275,689 275,542 275,399 298,292 345,221 391,149 464,113 563,113 671,113 748,148 795,217 841,286 864,395 864,542 Z"/>
+   <glyph unicode="n" horiz-adv-x="874" d="M 825,0 L 825,686 C 825,757 818,813 804,852 790,891 768,920 737,937 706,954 661,963 602,963 515,963 447,933 397,874 347,815 322,732 322,627 L 322,0 142,0 142,851 C 142,977 140,1054 136,1082 L 306,1082 C 307,1079 307,1070 308,1055 309,1040 310,1024 311,1005 312,986 313,950 314,897 L 317,897 C 358,972 406,1025 461,1056 515,1087 582,1102 663,1102 782,1102 869,1073 924,1014 979,955 1006,857 1006,721 L 1006,0 825,0 Z"/>
+   <glyph unicode="m" horiz-adv-x="1457" d="M 768,0 L 768,686 C 768,791 754,863 725,903 696,943 645,963 570,963 493,963 433,934 388,875 343,816 321,734 321,627 L 321,0 142,0 142,851 C 142,977 140,1054 136,1082 L 306,1082 C 307,1079 307,1070 308,1055 309,1040 310,1024 311,1005 312,986 313,950 314,897 L 317,897 C 356,974 400,1027 450,1057 500,1087 561,1102 633,1102 715,1102 780,1086 828,1053 875,1020 908,968 927,897 L 930,897 C 967,970 1013,1022 1066,1054 1119,1086 1183,1102 1258,1102 1367,1102 1447,1072 1497,1013 1546,954 1571,856 1571,721 L 1571,0 1393,0 1393,686 C 1393,791 1379,863 1350,903 1321,943 1270,963 1195,963 1116,963 1055,934 1012,876 968,817 946,734 946,627 L 946,0 768,0 Z"/>
+   <glyph unicode="l" horiz-adv-x="187" d="M 138,0 L 138,1484 318,1484 318,0 138,0 Z"/>
+   <glyph unicode="i" horiz-adv-x="187" d="M 137,1312 L 137,1484 317,1484 317,1312 137,1312 Z M 137,0 L 137,1082 317,1082 317,0 137,0 Z"/>
+   <glyph unicode="g" horiz-adv-x="927" d="M 548,-425 C 430,-425 336,-402 266,-356 196,-309 151,-243 131,-158 L 312,-132 C 324,-182 351,-220 392,-248 433,-274 486,-288 553,-288 732,-288 822,-183 822,27 L 822,201 820,201 C 786,132 739,80 680,45 621,10 551,-8 472,-8 339,-8 242,36 180,124 117,212 86,350 86,539 86,730 120,872 187,963 254,1054 355,1099 492,1099 569,1099 635,1082 692,1047 748,1012 791,962 822,897 L 824,897 C 824,917 825,952 828,1001 831,1050 833,1077 836,1082 L 1007,1082 C 1003,1046 1001,971 1001,858 L 1001,31 C 1001,-273 850,-425 548,-425 Z M 822,541 C 822,629 810,705 786,769 762,832 728,881 685,915 641,948 591,965 536,965 444,965 377,932 335,865 293,798 272,690 272,541 272,393 292,287 331,222 370,157 438,125 533,125 590,125 640,142 684,175 728,208 762,256 786,319 810,381 822,455 822,541 Z"/>
+   <glyph unicode="e" horiz-adv-x="980" d="M 276,503 C 276,379 302,283 353,216 404,149 479,115 578,115 656,115 719,131 766,162 813,193 844,233 861,281 L 1019,236 C 954,65 807,-20 578,-20 418,-20 296,28 213,123 129,218 87,360 87,548 87,727 129,864 213,959 296,1054 416,1102 571,1102 889,1102 1048,910 1048,527 L 1048,503 276,503 Z M 862,641 C 852,755 823,838 775,891 727,943 658,969 568,969 481,969 412,940 361,882 310,823 282,743 278,641 L 862,641 Z"/>
+   <glyph unicode="d" horiz-adv-x="927" d="M 821,174 C 788,105 744,55 689,25 634,-5 565,-20 484,-20 347,-20 247,26 183,118 118,210 86,349 86,536 86,913 219,1102 484,1102 566,1102 634,1087 689,1057 744,1027 788,979 821,914 L 823,914 821,1035 821,1484 1001,1484 1001,223 C 1001,110 1003,36 1007,0 L 835,0 C 833,11 831,35 829,74 826,113 825,146 825,174 L 821,174 Z M 275,542 C 275,391 295,282 335,217 375,152 440,119 530,119 632,119 706,154 752,225 798,296 821,405 821,554 821,697 798,802 752,869 706,936 633,969 532,969 441,969 376,936 336,869 295,802 275,693 275,542 Z"/>
+   <glyph unicode="c" horiz-adv-x="901" d="M 275,546 C 275,402 298,295 343,226 388,157 457,122 548,122 612,122 666,139 709,174 752,209 778,262 788,334 L 970,322 C 956,218 912,135 837,73 762,11 668,-20 553,-20 402,-20 286,28 207,124 127,219 87,359 87,542 87,724 127,863 207,959 287,1054 402,1102 551,1102 662,1102 754,1073 827,1016 900,959 945,880 964,779 L 779,765 C 770,825 746,873 708,908 670,943 616,961 546,961 451,961 382,929 339,866 296,803 275,696 275,546 Z"/>
+   <glyph unicode="a" horiz-adv-x="1060" d="M 414,-20 C 305,-20 224,9 169,66 114,123 87,202 87,302 87,414 124,500 198,560 271,620 390,652 554,656 L 797,660 797,719 C 797,807 778,870 741,908 704,946 645,965 565,965 484,965 426,951 389,924 352,897 330,853 323,793 L 135,810 C 166,1005 310,1102 569,1102 705,1102 807,1071 876,1009 945,946 979,856 979,738 L 979,272 C 979,219 986,179 1000,152 1014,125 1041,111 1080,111 1097,111 1117,113 1139,118 L 1139,6 C 1094,-5 1047,-10 1000,-10 933,-10 885,8 855,43 824,78 807,132 803,207 L 797,207 C 751,124 698,66 637,32 576,-3 501,-20 414,-20 Z M 455,115 C 521,115 580,130 631,160 682,190 723,231 753,284 782,336 797,390 797,445 L 797,534 600,530 C 515,529 451,520 408,504 364,488 330,463 307,430 284,397 272,353 272,299 272,240 288,195 320,163 351,131 396,115 455,115 Z"/>
+   <glyph unicode="_" horiz-adv-x="1218" d="M -31,-407 L -31,-277 1162,-277 1162,-407 -31,-407 Z"/>
+   <glyph unicode="S" horiz-adv-x="1192" d="M 1272,389 C 1272,259 1221,158 1120,87 1018,16 875,-20 690,-20 347,-20 148,99 93,338 L 278,375 C 299,290 345,228 414,189 483,149 578,129 697,129 820,129 916,150 983,193 1050,235 1083,297 1083,379 1083,425 1073,462 1052,491 1031,520 1001,543 963,562 925,581 880,596 827,609 774,622 716,635 652,650 541,675 456,699 399,724 341,749 295,776 262,807 229,837 203,872 186,913 168,954 159,1000 159,1053 159,1174 205,1267 298,1332 390,1397 522,1430 694,1430 854,1430 976,1406 1061,1357 1146,1308 1205,1224 1239,1106 L 1051,1073 C 1030,1148 991,1202 933,1236 875,1269 795,1286 692,1286 579,1286 493,1267 434,1230 375,1193 345,1137 345,1063 345,1020 357,984 380,956 403,927 436,903 479,884 522,864 609,840 738,811 781,801 825,791 868,781 911,770 952,758 991,744 1030,729 1067,712 1102,693 1136,674 1166,650 1191,622 1216,594 1236,561 1251,523 1265,485 1272,440 1272,389 Z"/>
+   <glyph unicode="P" horiz-adv-x="1112" d="M 1258,985 C 1258,852 1215,746 1128,667 1041,588 922,549 773,549 L 359,549 359,0 168,0 168,1409 761,1409 C 919,1409 1041,1372 1128,1298 1215,1224 1258,1120 1258,985 Z M 1066,983 C 1066,1165 957,1256 738,1256 L 359,1256 359,700 746,700 C 959,700 1066,794 1066,983 Z"/>
+   <glyph unicode="E" horiz-adv-x="1138" d="M 168,0 L 168,1409 1237,1409 1237,1253 359,1253 359,801 1177,801 1177,647 359,647 359,156 1278,156 1278,0 168,0 Z"/>
+   <glyph unicode="D" horiz-adv-x="1218" d="M 1381,719 C 1381,574 1353,447 1296,338 1239,229 1159,145 1055,87 951,29 831,0 695,0 L 168,0 168,1409 634,1409 C 873,1409 1057,1349 1187,1230 1316,1110 1381,940 1381,719 Z M 1189,719 C 1189,894 1141,1027 1046,1119 950,1210 811,1256 630,1256 L 359,1256 359,153 673,153 C 776,153 867,176 946,221 1024,266 1084,332 1126,417 1168,502 1189,603 1189,719 Z"/>
+   <glyph unicode="A" horiz-adv-x="1377" d="M 1167,0 L 1006,412 364,412 202,0 4,0 579,1409 796,1409 1362,0 1167,0 Z M 685,1265 L 676,1237 C 659,1182 635,1111 602,1024 L 422,561 949,561 768,1026 C 749,1072 731,1124 712,1182 L 685,1265 Z"/>
+   <glyph unicode="1" horiz-adv-x="927" d="M 156,0 L 156,153 515,153 515,1237 197,1010 197,1180 530,1409 696,1409 696,153 1039,153 1039,0 156,0 Z"/>
+   <glyph unicode="/" horiz-adv-x="583" d="M 0,-20 L 411,1484 569,1484 162,-20 0,-20 Z"/>
+   <glyph unicode=" " horiz-adv-x="556"/>
+  </font>
+ </defs>
+ <defs class="TextShapeIndex">
+  <g ooo:slide="id1" ooo:id-list="id3 id4 id5 id6 id7 id8 id9 id10 id11 id12 id13 id14 id15 id16"/>
+ </defs>
+ <defs class="EmbeddedBulletChars">
+  <g id="bullet-char-template-57356" transform="scale(0.00048828125,-0.00048828125)">
+   <path d="M 580,1141 L 1163,571 580,0 -4,571 580,1141 Z"/>
+  </g>
+  <g id="bullet-char-template-57354" transform="scale(0.00048828125,-0.00048828125)">
+   <path d="M 8,1128 L 1137,1128 1137,0 8,0 8,1128 Z"/>
+  </g>
+  <g id="bullet-char-template-10146" transform="scale(0.00048828125,-0.00048828125)">
+   <path d="M 174,0 L 602,739 174,1481 1456,739 174,0 Z M 1358,739 L 309,1346 659,739 1358,739 Z"/>
+  </g>
+  <g id="bullet-char-template-10132" transform="scale(0.00048828125,-0.00048828125)">
+   <path d="M 2015,739 L 1276,0 717,0 1260,543 174,543 174,936 1260,936 717,1481 1274,1481 2015,739 Z"/>
+  </g>
+  <g id="bullet-char-template-10007" transform="scale(0.00048828125,-0.00048828125)">
+   <path d="M 0,-2 C -7,14 -16,27 -25,37 L 356,567 C 262,823 215,952 215,954 215,979 228,992 255,992 264,992 276,990 289,987 310,991 331,999 354,1012 L 381,999 492,748 772,1049 836,1024 860,1049 C 881,1039 901,1025 922,1006 886,937 835,863 770,784 769,783 710,716 594,584 L 774,223 C 774,196 753,168 711,139 L 727,119 C 717,90 699,76 672,76 641,76 570,178 457,381 L 164,-76 C 142,-110 111,-127 72,-127 30,-127 9,-110 8,-76 1,-67 -2,-52 -2,-32 -2,-23 -1,-13 0,-2 Z"/>
+  </g>
+  <g id="bullet-char-template-10004" transform="scale(0.00048828125,-0.00048828125)">
+   <path d="M 285,-33 C 182,-33 111,30 74,156 52,228 41,333 41,471 41,549 55,616 82,672 116,743 169,778 240,778 293,778 328,747 346,684 L 369,508 C 377,444 397,411 428,410 L 1163,1116 C 1174,1127 1196,1133 1229,1133 1271,1133 1292,1118 1292,1087 L 1292,965 C 1292,929 1282,901 1262,881 L 442,47 C 390,-6 338,-33 285,-33 Z"/>
+  </g>
+  <g id="bullet-char-template-9679" transform="scale(0.00048828125,-0.00048828125)">
+   <path d="M 813,0 C 632,0 489,54 383,161 276,268 223,411 223,592 223,773 276,916 383,1023 489,1130 632,1184 813,1184 992,1184 1136,1130 1245,1023 1353,916 1407,772 1407,592 1407,412 1353,268 1245,161 1136,54 992,0 813,0 Z"/>
+  </g>
+  <g id="bullet-char-template-8226" transform="scale(0.00048828125,-0.00048828125)">
+   <path d="M 346,457 C 273,457 209,483 155,535 101,586 74,649 74,723 74,796 101,859 155,911 209,963 273,989 346,989 419,989 480,963 531,910 582,859 608,796 608,723 608,648 583,586 532,535 482,483 420,457 346,457 Z"/>
+  </g>
+  <g id="bullet-char-template-8211" transform="scale(0.00048828125,-0.00048828125)">
+   <path d="M -4,459 L 1135,459 1135,606 -4,606 -4,459 Z"/>
+  </g>
+  <g id="bullet-char-template-61548" transform="scale(0.00048828125,-0.00048828125)">
+   <path d="M 173,740 C 173,903 231,1043 346,1159 462,1274 601,1332 765,1332 928,1332 1067,1274 1183,1159 1299,1043 1357,903 1357,740 1357,577 1299,437 1183,322 1067,206 928,148 765,148 601,148 462,206 346,322 231,437 173,577 173,740 Z"/>
+  </g>
+ </defs>
+ <g>
+  <g id="id2" class="Master_Slide">
+   <g id="bg-id2" class="Background"/>
+   <g id="bo-id2" class="BackgroundObjects"/>
+  </g>
+ </g>
+ <g class="SlideGroup">
+  <g>
+   <g id="container-id1">
+    <g id="id1" class="Slide" clip-path="url(#presentation_clip_path)">
+     <g class="Page">
+      <g class="com.sun.star.drawing.CustomShape">
+       <g id="id3">
+        <rect class="BoundingBox" stroke="none" fill="none" x="1999" y="2099" width="11803" height="1103"/>
+        <path fill="rgb(114,159,207)" stroke="none" d="M 7900,3200 L 2000,3200 2000,2100 13800,2100 13800,3200 7900,3200 Z"/>
+        <path fill="none" stroke="rgb(52,101,164)" d="M 7900,3200 L 2000,3200 2000,2100 13800,2100 13800,3200 7900,3200 Z"/>
+        <text class="TextShape"><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="635px" font-weight="400"><tspan class="TextPosition" x="3426" y="2871"><tspan fill="rgb(0,0,0)" stroke="none">EditorStandard / EditorPremium</tspan></tspan></tspan></text>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.CustomShape">
+       <g id="id4">
+        <rect class="BoundingBox" stroke="none" fill="none" x="16999" y="2099" width="10103" height="1103"/>
+        <path fill="rgb(114,159,207)" stroke="none" d="M 22050,3200 L 17000,3200 17000,2100 27100,2100 27100,3200 22050,3200 Z"/>
+        <path fill="none" stroke="rgb(52,101,164)" d="M 22050,3200 L 17000,3200 17000,2100 27100,2100 27100,3200 22050,3200 Z"/>
+        <text class="TextShape"><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="635px" font-weight="400"><tspan class="TextPosition" x="17455" y="2871"><tspan fill="rgb(0,0,0)" stroke="none">AdminStandard / AdminPremium</tspan></tspan></tspan></text>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.CustomShape">
+       <g id="id5">
+        <rect class="BoundingBox" stroke="none" fill="none" x="15399" y="11099" width="4704" height="2204"/>
+        <path fill="rgb(255,128,0)" stroke="none" d="M 17750,11100 L 20101,12200 17750,13301 15400,12200 17750,11100 17750,11100 Z"/>
+        <path fill="none" stroke="rgb(52,101,164)" d="M 17750,11100 L 20101,12200 17750,13301 15400,12200 17750,11100 17750,11100 Z"/>
+        <text class="TextShape"><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="635px" font-weight="400"><tspan class="TextPosition" x="16219" y="12421"><tspan fill="rgb(0,0,0)" stroke="none">admin_site</tspan></tspan></tspan></text>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.CustomShape">
+       <g id="id6">
+        <rect class="BoundingBox" stroke="none" fill="none" x="1799" y="11399" width="4704" height="2204"/>
+        <path fill="rgb(255,128,0)" stroke="none" d="M 4150,11400 L 6501,12500 4150,13601 1800,12500 4150,11400 4150,11400 Z"/>
+        <path fill="none" stroke="rgb(52,101,164)" d="M 4150,11400 L 6501,12500 4150,13601 1800,12500 4150,11400 4150,11400 Z"/>
+        <text class="TextShape"><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="635px" font-weight="400"><tspan class="TextPosition" x="3182" y="12721"><tspan fill="rgb(0,0,0)" stroke="none">editor1</tspan></tspan></tspan></text>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.CustomShape">
+       <g id="id7">
+        <rect class="BoundingBox" stroke="none" fill="none" x="1799" y="6099" width="14303" height="1103"/>
+        <path fill="rgb(114,159,207)" stroke="none" d="M 8950,7200 L 1800,7200 1800,6100 16100,6100 16100,7200 8950,7200 Z"/>
+        <path fill="none" stroke="rgb(52,101,164)" d="M 8950,7200 L 1800,7200 1800,6100 16100,6100 16100,7200 8950,7200 Z"/>
+        <text class="TextShape"><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="635px" font-weight="400"><tspan class="TextPosition" x="7348" y="6871"><tspan fill="rgb(0,0,0)" stroke="none">edit_mysite</tspan></tspan></tspan></text>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.ConnectorShape">
+       <g id="id8">
+        <rect class="BoundingBox" stroke="none" fill="none" x="7899" y="3199" width="1202" height="2902"/>
+        <path fill="none" stroke="rgb(52,101,164)" d="M 7900,3200 L 7900,3701 8950,5599 8950,5670"/>
+        <path fill="rgb(52,101,164)" stroke="none" d="M 8950,6100 L 9100,5650 8800,5650 8950,6100 Z"/>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.ConnectorShape">
+       <g id="id9">
+        <rect class="BoundingBox" stroke="none" fill="none" x="4000" y="7199" width="4952" height="4202"/>
+        <path fill="none" stroke="rgb(52,101,164)" d="M 8950,7200 L 8950,9500 4150,10899 4150,10970"/>
+        <path fill="rgb(52,101,164)" stroke="none" d="M 4150,11400 L 4300,10950 4000,10950 4150,11400 Z"/>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.ConnectorShape">
+       <g id="id10">
+        <rect class="BoundingBox" stroke="none" fill="none" x="8949" y="7199" width="8952" height="3902"/>
+        <path fill="none" stroke="rgb(52,101,164)" d="M 8950,7200 L 8950,9500 17750,10599 17750,10670"/>
+        <path fill="rgb(52,101,164)" stroke="none" d="M 17750,11100 L 17900,10650 17600,10650 17750,11100 Z"/>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.ConnectorShape">
+       <g id="id11">
+        <rect class="BoundingBox" stroke="none" fill="none" x="17600" y="3199" width="4452" height="7902"/>
+        <path fill="none" stroke="rgb(52,101,164)" d="M 22050,3200 L 22050,3701 17750,10599 17750,10670"/>
+        <path fill="rgb(52,101,164)" stroke="none" d="M 17750,11100 L 17900,10650 17600,10650 17750,11100 Z"/>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.TextShape">
+       <g id="id12">
+        <rect class="BoundingBox" stroke="none" fill="none" x="4200" y="3900" width="4601" height="1362"/>
+        <text class="TextShape"><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="494px" font-weight="400"><tspan class="TextPosition" x="4450" y="4474"><tspan fill="rgb(0,0,0)" stroke="none">Accès aux </tspan></tspan><tspan class="TextPosition" x="4450" y="5029"><tspan fill="rgb(0,0,0)" stroke="none">modules d’édition</tspan></tspan></tspan></text>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.TextShape">
+       <g id="id13">
+        <rect class="BoundingBox" stroke="none" fill="none" x="21000" y="5384" width="4601" height="1917"/>
+        <text class="TextShape"><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="494px" font-weight="400"><tspan class="TextPosition" x="21250" y="5958"><tspan fill="rgb(0,0,0)" stroke="none">Accès aux </tspan></tspan><tspan class="TextPosition" x="21250" y="6513"><tspan fill="rgb(0,0,0)" stroke="none">modules </tspan></tspan><tspan class="TextPosition" x="21250" y="7068"><tspan fill="rgb(0,0,0)" stroke="none">d’administration</tspan></tspan></tspan></text>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.TextShape">
+       <g id="id14">
+        <rect class="BoundingBox" stroke="none" fill="none" x="5000" y="7700" width="4601" height="1362"/>
+        <text class="TextShape"><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="494px" font-weight="400"><tspan class="TextPosition" x="5250" y="8274"><tspan fill="rgb(0,0,0)" stroke="none">Droits d’édition </tspan></tspan><tspan class="TextPosition" x="5250" y="8829"><tspan fill="rgb(0,0,0)" stroke="none">sur les pages</tspan></tspan></tspan></text>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.ConnectorShape">
+       <g id="id15">
+        <rect class="BoundingBox" stroke="none" fill="none" x="20100" y="10929" width="2753" height="1422"/>
+        <path fill="none" stroke="rgb(52,101,164)" d="M 22851,10930 L 20602,12200 20530,12200"/>
+        <path fill="rgb(52,101,164)" stroke="none" d="M 20100,12200 L 20550,12350 20550,12050 20100,12200 Z"/>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.TextShape">
+       <g id="id16">
+        <rect class="BoundingBox" stroke="none" fill="none" x="23000" y="9474" width="4601" height="3027"/>
+        <text class="TextShape"><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="494px" font-weight="400"><tspan class="TextPosition" x="23250" y="10048"><tspan fill="rgb(0,0,0)" stroke="none">A les droits </tspan></tspan><tspan class="TextPosition" x="23250" y="10603"><tspan fill="rgb(0,0,0)" stroke="none">d’administrations </tspan></tspan><tspan class="TextPosition" x="23250" y="11158"><tspan fill="rgb(0,0,0)" stroke="none">sur les pages en </tspan></tspan><tspan class="TextPosition" x="23250" y="11713"><tspan fill="rgb(0,0,0)" stroke="none">tant que </tspan></tspan><tspan class="TextPosition" x="23250" y="12268"><tspan fill="rgb(0,0,0)" stroke="none">propriétaire</tspan></tspan></tspan></text>
+       </g>
+      </g>
+     </g>
+    </g>
+   </g>
+  </g>
+ </g>
+</svg>

doc/images/v.svg

@@ -0,0 +1 @@
+<svg width="16" height="16" xmlns="http://www.w3.org/2000/svg"><g fill="none" fill-rule="evenodd"><circle fill="#00875A" cx="8" cy="8" r="8"/><path d="M10.242 4.474a.941.941 0 0 1 1.634.934L8.11 11.996a.941.941 0 0 1-1.54.136L4.218 9.308a.941.941 0 1 1 1.446-1.205L7.15 9.886l3.093-5.412z" stroke="#FFF" stroke-width=".2" fill="#FFF" fill-rule="nonzero"/></g></svg>

doc/images/x.svg

@@ -0,0 +1 @@
+<svg width="16" height="16" xmlns="http://www.w3.org/2000/svg"><g fill="none" fill-rule="evenodd"><circle fill="#DE350B" cx="8" cy="8" r="8"/><path d="M9.485 8.071l2.122 2.121a1 1 0 1 1-1.415 1.415l-2.12-2.122-2.122 2.122a1 1 0 1 1-1.414-1.415l2.12-2.12-2.12-2.122A1 1 0 1 1 5.95 4.536l2.121 2.12 2.121-2.12a1 1 0 1 1 1.415 1.414L9.485 8.07z" fill="#FFF"/></g></svg>

doc/installation.md

@@ -0,0 +1,98 @@
+
+## Détails de l'installation
+
+Typo3 est installé sur prod-front et sur preprod en double instance:
+
+| Instance | Mini-sites | Portail |
+| --- | --- | --- |
+| vhost | 001-sub.opentalent.fr.conf | 001-opentalent.fr.conf |
+| php | 7.4 | 7.0 |
+| Version Typo3 | 9.5 | 8.7 |
+| source directory | /var/www/typo3 | /var/www/typo3_82 |
+| Url du backend | https://ohcluses.opentalent.fr/typo3/ | https://opentalent.fr/typo3/ |
+
+
+**Important: Pour la suite de cette documentation, on ne parlera plus que de l'installation la plus récente (v9.5)**
+
+
+Les [extensions Opentalent](..) sont installées dans: /var/opentalent/git/ot_typo3
+
+## Opérations courantes
+
+### Faire une sauvegarde des données
+
+
+Faire un dump compressé de la DB (requiert environ 1Go en 2021):
+
+
+    mysqldump --single-transaction --compress -u dbcloner --password=**** typo3 | gzip -c > dump_typo3_yyyymmdd.gz
+
+
+Sauvegarder la configuration des sites (volume négligeable)
+
+
+    tar czvf ./sites.tar.gz /var/www/typo3/config/sites
+
+
+Sauvegarder les uploads et les définitions des formulaires (de l'ordre de la centaine de Go):
+
+
+    tar czvf ./fileadmin.tar.gz /var/www/typo3/public/fileadmin
+
+
+### Déployer une nouvelle version des extensions
+
+
+    ssh -A exploitation@[preprod ou prod-front]
+    cd /var/opentalent/git/ot_typo3
+    git pull
+
+
+### Mettre à jour Typo3
+
+
+
+Pour voir les dernières versions disponibles:
+
+    composer outdated
+
+Pour mettre à jour typo3:
+
+    composer update
+
+Pour tout mettre à jour:
+
+    composer update
+
+
+### Synchroniser les données depuis prod-front sur preprod
+
+
+    ssh -A exploitation@preprod
+
+    # databases
+    cd ~/clonedb
+    python3.8 clonedb.py typo3
+    
+    # files
+    rsync -av --delete exploitation@prod-front:/var/www/typo3/config/sites/ /var/www/typo3/config/sites/
+    rsync -av --delete exploitation@prod-front:/var/www/typo3/public/fileadmin/ /var/www/typo3/public/fileadmin/
+    
+    rsync -av --delete exploitation@prod-front:/var/www/typo3/archive/ /var/www/typo3/archive/
+
+
+### Mettre en mode maintenance
+
+Pour mettre une instance Typo3 en mode maintenance, accéder au serveur en ssh et éditer le .htaccess:
+
+    ssh -A exploitation@preprod
+    nano /var/www/typo3/public/.htaccess
+
+Et décommenter les lignes:
+
+    #RewriteCond %{REMOTE_ADDR} !^10\.8\.0\.[0-255]
+    #RewriteCond %{REQUEST_URI} !/maintenance.html$ [NC]
+    #RewriteRule .* /maintenance.html [R=302,L]
+
+Puis recommenter pour désactiver le mode maintenance.
+

doc/readme.md

@@ -0,0 +1,113 @@
+# Typo3
+
+Typo3 est un [CMS opensource](https://typo3.fr/) adapté à la gestion d'une arborescence de sites.
+
+En 2021, l'usine à site Opentalent héberge près de 3800 sites internet (soit 63600 pages), 
+plus environ 2000 sites archivés.
+
+**Sommaire**
+
+* [Détails de l'installation et opérations courantes](installation.md)
+* [Versions et dépendances](dependencies.md)
+* [Backend users: droits des administrateurs et des éditeurs](be_users.md)
+* [Optimisation de la résolution d'url](routing.md)
+* [Gestion des formulaires](forms.md)
+
+
+
+## Objectifs
+
+Les objectifs principaux de cette usine à site sont les suivants:
+
+* Fournir un site internet à chaque structure cliente, ainsi qu'un compte administrateur pour ce même site
+* Permettre à chaque structure de créer, modifier, et supprimer les pages et leurs contenus, dans la limite des droits 
+  que leurs confèrent leur licence Opentalent
+* Intégrer automatiquement les flux de données issues du réseau Opentalent (évènements, partenaires, structures adhérentes...)
+* Donner un lien d'accès à l'espace membres de la structure (i.e. le logiciel Opentalent)
+
+
+A ces objectifs initiaux s'ajoutent certaines fonctionnalités attendues, dont les principales:
+
+* la possibilité de choisir entre plusieurs templates de site
+* l'intégration des réseaux sociaux
+* un système de gestion des actualités
+* le respect de la réglementation (cookies, RGPD, mentions légales)
+* la possibilité de restreindre l'accès à certaines pages aux seuls adhérents
+* la possibilité d'attribuer les droits d'éditions à d'autres utilisateurs membres de la structure
+* un système de suivi des statistiques de consultation du site
+* un formulaire de contact
+
+## Difficultés et choix techniques
+
+### Modularité et dépendances
+
+Typo3 intègre un système d'extensions bien conçu, ce qui autorise un 
+développement organisé et modulaire dans lequel chaque problématique peut correspondre à une extension dédiée.
+
+Cependant, le risque lié à une multiplication des extensions reste une interdépendance de ces extensions (l'effet "spaghetti")
+
+Pour éviter ça, on se tiendra donc à ce principe: 
+
+* l'extension "noyau" [OtCore](/ot_core) ne dépend d'aucune autre extension 
+* toutes les autres extensions ne peuvent dépendre que de la seule extension: [OtCore](/ot_core)
+
+```mermaid
+graph TD;
+    OtCore-->OtAdmin;
+    OtCore-->OtTemplating;
+    OtCore-->OtConnect;
+    OtCore-->OtStats;
+    OtCore-->...etc.;
+```
+
+### Design
+
+La multiplicité des contenus, des templates et des supports rend le design graphique délicat à maintenir.
+
+Afin de permettre une maintenabilité du code front, les choix suivants ont été faits:
+
+* une extension unique est responsable du templating: [OtTemplating](/ot_templating)
+* chaque template est indépendant des autres, et dispose de ses propres layouts, partials, assets
+* cependant, tous les templates implémentent les même modèles de page (page d'accueil, liste des évènements, liste des adhérents...)
+* les assets de chaque template sont organisés de manière similaire, en respectant entre autre la méthode [SMACCS](http://smacss.com/files/smacss-fr.pdf)
+* un/des site(s) de démonstration, contenant tous les types de pages et de contenus, permettent de constater l'aspect graphique de ces éléments.
+
+### Authentification
+
+Le partage d'une authentification entre le logiciel et les sites est effectué par l'intermédiaire de cookies.
+
+L'extension dédiée [OtConnect](/ot_connect) permet de soumettre ces cookies à l'API pour obtenir l'identité de l'utilisateur connecté.
+
+Ce fonctionnement rencontre cependant des difficultés liées aux règles de sécurité des navigateurs liées aux cookies,
+ainsi qu'aux structures possédant leur propre nom de domaine (domaines qui ne sont donc plus en `.opentalent.fr`)
+
+### Nombre de sites
+
+Tout adapté qu'il soit à l'architecture multi-sites, Typo3 n'a pas été pensé pour héberger une telle quantité de sites.
+De nombreuses difficultés liées à ce nombre ont donc dû être contournées.
+
+C'est la raison d'être de l'extension [OtOptimizer](/ot_admin), dont le rôle est de surcharger le fonctionnement de certaines fonctions
+natives de Typo3 pour des raisons de performance.
+
+### Cohérence avec les données Opentalent
+
+Les sites doivent être à tout moment cohérents avec les données de la base de données Opentalent (structures, utilisateurs, paramètre...).
+
+Pour ce faire, l'extension [OtAdmin](/ot_admin) fournit une API accessible par HTTP et en ligne de commande.
+Cette API est appellées par des hooks côté logiciel et permet de déclencher par exemple la création d'un nouveau site, sa mise à jour,
+ou son archivage.
+
+### Typoscript
+
+LE Typoscript. C'est le langage historique de Typo3. Très puissant, mais... [fiou](https://docs.typo3.org/m/typo3/tutorial-typoscript-in-45-minutes/master/en-us/TypoScriptFunctions/If/Index.html).
+
+Bref, le Typoscript étant assez difficile d'accès, le choix a été fait de privilégier l'usage du langage de 
+templating [Fluid](https://typo3.org/fluid/) dès que c'était possible.
+
+Plus d'infos [ici](dependencies.md).
+
+-------------------------
+
+Et si vous avez lu jusqu'ici, vous avez bien mérité un cookie:
+
+![cookie](images/cookie.png)

doc/routing.md

@@ -0,0 +1,93 @@
+# Optimisation de la résolution d'URLs (routing)
+
+
+## Problématique initiale
+
+Typo3 n'a pas été pensé pour héberger des milliers de sites comme c'est le cas ici, Ce qui provoque un certain nombre de lenteurs, au niveau de l'affichage de certains écrans du backend par exemple. Une conséquence est que la résolution des urls par le système de routing est longue et consomme trop de puissance de calcul, causant à la fois une dégradation des performances et un risque de déni de service.
+
+Le problème se pose à la fois dans le cas d'une page existante (200) et d'une page inexistante (404), car les erreurs 404 impliquent la même charge de travail pour le serveur que les pages existantes.
+
+Deux étapes sont principalement concernées:
+
+
+### La résolution du domaine
+
+Pour associer le domaine utilisé à un site, le routeur Typo3 parse les fichiers de configuration *config.yaml* stockés dans `/var/www/typo3/config/sites`
+
+Il existe un fichier par site, soit près de 6000 dans notre cas en 2021.
+
+Au premier affichage, le temps d'accès disque et de parsing est donc extrêmement long.
+
+Lors des accès suivants, ces configurations sont en cache, ce qui réduit l'impact.
+
+Cependant, le router instancie tous les sites avant de faire finalement correspondre le domaine utilisé dans la requête à l'uid de la page racine d'un site.
+
+[blackfire_1](images/routing_blackfire_1.png)
+
+
+### La résolution du chemin
+
+Une fois la correspondance entre le domaine et un site effectuée, une deuxième étape consiste à résoudre le chemin 
+(path, ou slug) et à le faire correspondre à une page.
+
+Encore une fois, typo3 n'est pas conçu pour héberger autant de site. Pour effectuer cette résolution, Typo3 récupère en 
+base toutes les pages dont le slug correspond à la requête. Ensuite, le routeur vérifie pour chacune de ces pages 
+si elle fait partie du site déterminé à l'étape précédente.
+
+Ce qui implique, lorsque la requête concerne un slug commun comme la page d'accueil '/', que jusqu'à 6000 requêtes peuvent 
+être effectuées en base pour la résolution d'une seule page!
+
+
+
+## Mesures d'optimisation
+
+Pour parer à ces problèmes, l'extension [ot_optimizer](/ot_optimizer) implémente des [XClass](https://docs.typo3.org/m/typo3/reference-coreapi/master/en-us/ApiOverview/Xclasses/Index.html) 
+qui vont se substituer à certaines classes Typo3 responsable du routing.
+
+Le rôle de ces classes sera donc de faire correspondre un domaine à un site via les enregistrements de la table 
+'ot_websites', puis un slug à l'uid d'une page grâce au champs 'slug' de la table 'pages'.
+
+**IMPORTANT**: ces mesures ne sont appliquées qu'aux requêtes Frontend.
+
+
+### Garder les routes à jour
+
+Un hook est nécessaire dans le logiciel pour garder à jour le champs 'subdomain' de la table 'ot_websites'. 
+Ce hook est déclenché par la requête http: `<typo3_host>/typo3/index.php?route=/otadmin/site/update&organization-id=<organization_id>`
+
+La redirection peut-être ajoutée en ligne de commande (voir [ot_admin](/ot_admin))
+
+
+### Faut-il prévoir un fallback vers le fonctionnement par défaut?
+
+Aucun fallback vers le router natif de Typo3 n'est prévu, car un fonctionnement de ce genre annulerait les 
+bénéfices de l'index dans le cas des erreurs 404.
+
+
+### Cas particuliers
+
+#### Gérer les redirections
+
+Certains domaines font l'objet de redirections vers un autre nom de domaine. Il faut s'assurer que cette redirection puisse avoir lieu.
+
+#### Les pages à accès restreint
+
+Les pages à accès restreint doivent apparaître dans la table de routage, Typo3 se chargera ensuite de déterminer 
+si l'utilisateur a le droit d'y accéder ou non.
+
+#### Les pages de type raccourci
+
+Les pages de type raccourci doivent apparaître dans la table de routage comme des pages normales, Typo3 se chargera 
+ensuite de la redirection. En effet, si on voulait gérer cette redirection directement au niveau de la table de routage, 
+il faudrait tenir compte du cas supplémentaire où la cible du raccourci est changée.
+
+#### Les urls en mode développement
+
+En mode développement (sur preprod ou en local), les urls ne sont pas construites de la même manière:
+
+| Prod | Dev |
+| --- | --- |
+| <subdomain>.opentalent.fr | host.opentalent.fr/<subdomain> |
+
+ 
+