OscarText (vBeta)

# Adapter le texte dans l'interface

## Introduction

Le module **OscarText** permet de modifier la terminologie au sein de l'application afin de mieux l'adapter à vos usages métier.

> Tous les textes de l'application ne sont pas pris en charge, l'intégration de ce module se concentre sur les principaux écrans.

## Utilisation

### Modification des textes généraux

Depuis l'interface d'aministration, allez dans Options > Personnaliser le texte. Tous les textes personnalisables y sont référencés.

Les changements sont effectifs après rechargement de la page

## Technique

### Gestionnaire d'application Oscar

Les textes personnalisés sont référencés dans le fichier JSON `config/autoload/oscar.text.custom.json`, assurez-vous qu'il est accessible en écriture

### Développeur

Lors de l'ajout de texte, une commande permet de générer le fichier qui référence les textes modifiables 

```bash

# Voir les chaînes trouvées et leurs correspondances

php bin/oscar.php text:oscar --debug

# Mettre à jour le fichier de référence

php bin/oscar.php text:oscar --base

```

La commande cherche 

 - `oscarText("LE TEXTE")` dans le dossier **module**, fichiers phtml/php

 - `$filters.oscarText("TEXTE")` dans le dossier **ui**, fichier vue

 No newline at end of file

# Internationnalisation

> ! Fonctionnalité dépréciée !

dans le cadre du projet ADAJ, Oscar intégre de façon rudimentaire une prise en charge partiel de l'internationnalisation d'éléments d'interface. Sont usage est pour le moment dédié à la modification de certains intitulés sans necessiter de *forker* les souces.

La gestion des traductions peut être réalisée avec le logiciel libre [Poedit 2](https://snapcraft.io/poedit).

### En cours

### Fonctionnel

 - **Général**

   - Personnalisation des textes de l'interface

 - **Fiche activité**

   - Disponibilité des champs

   - Champs requis

echo " - Fichier de configuration éditable (touch $VOLUMES_CONFIG/oscar-editable.yml)"

touch "$VOLUMES_CONFIG/oscar-editable.yml"

touch "$VOLUMES_CONFIG/oscar.text.custom.json"

################################################## CONFIGURATION des CONTAINERS

mkdir -p "$VOLUMES_CONFIG/apache"

chmod -R 777 $VOLUMES_LOG

chmod -R 777 $VOLUMES_TMP

chmod -R 777 "$VOLUMES_CONFIG/oscar-editable.yml"

chmod -R 777 "$VOLUMES_CONFIG/oscar.text.custom.json"

chmod -R 777 $VOLUMES_DOCUMENTS

chmod -R 777 $VOLUMES_CACHE_DOCTRINE

  props: {

    url: {required: true},

    first: {required: true, typ: Boolean},

    title: {default: "Activités de recherche"},

    title: {default: "Activités"},

    sortters: {required: true},

    moment: {require: true },

    filters: {required: true},