SP:HowTo
De Hegyd Doc.
How To
Cette rubrique est un pense bete réunissant les principales question à paropos de l'application des sites packagés.
Comment ajouter un type de blocObject?
- enregistrement en base du nouveau type
- création de sa classe php associée
- création des éventuels templates et controlers associés
Pour avoir le détail complet de chaque étape, rendez vous dans la section définition d'un blocObject
Comment ajouter une propriété éditable dans la customisation des styles?
- Se rendre dans le fichier de configuration de style correspondant au conteneur associé à la propriété (voir chapitre sur les conteneurs)
- Ajouter la propriété ( la configuration de propriétés de style).
- Tester
- Mise en production en prenant soin de rafriahcir tous le cache CSS des styles personnalisés (envoyer "y" lors de la demande de rafraichissement de cache lors de la mise en production).
Comment modifier une propriété éditable dans la customisation des styles
- Regarder ou sont définies les propriétés du conteneur dans le fichier de configuration de styles éditables.
- Se rendre dans la configuration associée au conteneur et modifier la propriété.
- Tester
- Mise en production en prenant soin de rafraichir tous le caches CSS des styles personnalisés (envoyer "y" lors de la demande de rafraichissement de cache lors de la mise en production).
ATTENTION: Il faut que les modifications n'entravent pas les styles des sites qui fonctionnaient avec la propriétés avant modification. Par exemple, dans le cas de changement d'unité,il faudra modifier les valeurs de la propriété sur les sites existant afin que l'apparence de leur site ne soit pas modifiée.
Comment ajouter un élément éditable dans la customisation des styles?
Vous devez d'abord cibler le path css de l'élément. Pour cela, ajouter une classe bien identifiable à l'élément dans le code HTML. Ensuite suivez le processus de configuration concernant les conteneurs.
Exemple
Ajout d'un style permettant de modifier la couleur du texte "Note : tous les champs sont obligatoires." dans les formulaire.
1.check dans la configuration générale si le conteneur permettatn de gérer les styles du formulaire existe: Non 2.création du conteneur dans la configuration générale, en ajtant le sous tableau:
'formContact' => array(
'blocId'=>Bloc::TYPE_CONTENT,
'blocObjectId'=>BlocObject::TYPE_IMAGE_GALLERY,
'type'=>StyleProperties::TYPE_FONT,
'targetElements'=> array('.formContact'), //chemin css du path associé au formulaire de contact dans le code HTML
'label'=>'Formulaire'
)
dans le tableau $stylePropertiesContainers. 3. On a besoin que de modifier la couleur du texte, on ne va pas faire appel a des conteneurs associés pour former la liste des propriétés éditable pour cet élément. On va créer un fichier formContact.php (meme nom que la clé dans le tableau de config générale) dans le repertoire des configurations conf/styleProperties, qui contiendra la propriété que l'on peut éditer. Voici le contenu:
$styles = array(
'fontColor' => array (
'type' => 'colorpicker',
'label' => 'couleur de la "note"',
'relatedColorNumber' => null,
'propertyToChange'=>'color', //on va pouvoir changer la propriété css de l'élement
'targetElements'=> array('.formRequired')//on affine le chemin css pour ne pas modifier la couleur de fond de tous les texte du bloc formulaire
)
Si la propriété contient color dans sa clé , alors elle sera considéré comme une propriété agissant sur la couleur (nécessaire pour que les palettes de couleurs agissent dessus).
C'est tout, il ne reste qu'a rafraichir la page de l'éditeur et tester.
Comment rajouter l'inclusion d'un fichier JS/CSS?
Il suffit d'ajouter le fichier dans le fichier de configuration du composant d'inclusion.
Comment sont gérés les coins arrondis?
La gestion ds coins arrondis est englobée dans une masterProperty liée au background de blocs. En effet, pour une comptabilité multi navigateurs, c'est une image en background qui génère les arrondis. Cette meme image permet également de gérer le remplissage du background (texture, couleur ou photo). C'est pourquoi la gestion des coins arrondis est associée a la gestion du background d'un élément en général.
