Hegyd Doc - Contributions de l’utilisateur [fr]

SP:Processus:Publication/Annulation

2010-07-30T13:01:38Z

Sebd : /* Publication/Annulation */

[[Category:SP:Processus]]

= Publication/Annulation =

Le site visible par le visiteur final peut être différent de celui vu dans l'éditeur. En effet la plupart des modification faites à partir de l'éditeur sont enregistrées en tant que brouillon, et n'affecte pas le site de production.
Les modifications effectuées peuvent alors être soient publiées soit annulées.

Ne '''sont pas''' concernées par le principe de publication/annulation:

* modifications portant sur le site: nom de domaine, et informations client.
* modifications portant sur les informations des pages. Néanmoins, [[SP:Composant:PageSiteClient#Statut_Brouillon_.2F_Publi.C3.A9|un flag]]permet d'indiquer le mode de la page.

'''Sont''' concernées par le processus:

* les modifications de contenu: contenu des pages, slogan
* les modifications de style: choix de theme, de palettes de couleur, de modèle, et styles personnalisés

== Processus général ==

La publication/l'annulation se fait en deux étapes. L'utilisateur choisit quelles modifications il souhaite publier: les modifications de contenu et/ou les modifications de style.
Ensuite chaque type de contenu est gérer séparément.

Ce processus est orchestré par lesfonctions se trouvant dans '''functionsPublish.js'''.

== Publication ==

La publication consiste en l'écrasement des données actuellement en production par les nouvelles actuellement en brouillon. Les données de brouillon sont ensuite supprimées.
Une seule exception a cette règle, le logo du site s'il est spécifié conserve toujours une valeur de brouillon, dans le cas ou il est supprimé.

Se fait en deux temps, par le biais de la fonction '''confirmPublish()''' (une fois que l'utilisateur a validé son choix).

* publication en elle meme , par le biais d'un appel AJAX
* raffraichissement des données de la page courante:
** rafraichissement de la CSS des [[SP:Composant:StyleProperties|styles personnalisés]].
** rafraichissement des blocs de contenu de la page courante.

=== Publication de contenu ===

* publication du [[SP:Composant:SiteClient#Publication|slogan]]
* publication des différentes [[SP:Composant:SiteClient#Publication|pages du site]].

=== Publication de styles ===

* affectation du theme de la palette de couleur et du modele à la version de production du site.
* [[SP:Composant:StyleProperties#Publicationenregistrement des styles sur la version de production]].

== Annulation ==

L'annulation consiste à la suppression de données de brouillon.

Se fait en deux temps, par le biais de la fonction '''confirmCancelPublish()''' (une fois que l'utilisateur a validé son choix).

* suppression en base des styles et du contenu brouillon via un appel AJAX
* raffraichissement des données de la page courante:
** rafraichissement javascript du contenu (si l'utilisateur a choisi d'annuler les modifications de contenu)
** rafraichissement javascript des menus de styles si l'on se trouve sur une des pages d'édition des styles (si l'utilisateur a choisi d'annuler les modifications de style).

SP:Processus:Publication/Annulation

2010-07-30T12:15:40Z

Sebd : /* Publication */

[[Category:SP:Processus]]

= Publication/Annulation =

Le site visible par le visiteur final peut être différent de celui vu dans l'éditeur. En effet la plupart des modification faites à partir de l'éditeur sont enregistrées en tant que brouillon, et n'affecte pas le site de production.
Les modifications effectuées peuvent alors être soient publiées soit annulées.

Ne '''sont pas''' concernées par le principe de publication/annulation:

* modifications portant sur le site: nom de domaine, et informations client.
* modifications portant sur les informations des pages. Néanmoins, [[SP:Composant:PageSiteClient#Statut_Brouillon_.2F_Publi.C3.A9|un flag]]permet d'indiquer le mode de la page.

'''Sont''' concernées par le processus:

* les modifications de contenu: contenu des pages, slogan
* les modifications de style: choix de theme, de palettes de couleur, de modèle, et styles personnalisés

== Processus général ==

La publication/l'annulation se fait en deux étapes. L'utilisateur choisit quelles modifications il souhaite publier: les modifications de contenu et/ou les modifications de style.
Ensuite chaque type de contenu est gérer séparément.

Ce processus est orchestré par lesfonctions se trouvant dans '''functionsPublish.js'''.

== Publication ==

La publication consiste en l'écrasement des données actuellement en production par les nouvelles actuellement en brouillone. Les données de brouillon sont ensuite supprimées.
Une seule exception a cette règle, le logo du site s'il est spécifié conserve toujours une valeur de brouillon, dans le cas ou il est supprimé. Néanmoins, il ne devrait pas dans l'idéal.

Se fait en deux temps, par le biais de la fonction '''confirmJS()''' dans tous les cas.

* publication en elle meme , par le biais d'un appel AJAX
* raffraichissement des données de la page:
** rafraichissement de la CSS des [[SP:Composant:StyleProperties|styles personnalisés]].
** rafraichissement des blocs de contenu de la page courante.

=== Publication de contenu ===

* publication du [[SP:Composant:SiteClient#Publication|slogan]]
* publication des différentes [[SP:Composant:SiteClient#Publication|pages du site]].

=== Publication de styles ===

* affectation du theme de la palette de couleur et du modele à la version de production du site.
* [[SP:Composant:StyleProperties#Publicationenregistrement des styles sur la version de production]].

SP:Processus:Gestion de contenu

2010-07-30T09:41:40Z

Sebd : /* Gestion de contenu */

[[Category:SP:Processus]]

= Gestion de contenu =

Diagramme montrant les différents composants agissant dans la gestion de contenu

[[Fichier:Composants_content.png]]

'''Legende''':

* contenu/fleches en vert: contenu utilisé pour afficher la version de production du contenu.
* contenu/fleches en orange: contenu utilisé sur la version éditeur
* contenu bleu: liaison non dépendante de la version du contenu utilisée (contenu de production/brouillon)

'''Explication'''

Un [[SP:Composant:SiteClient|site client]] est lié a un [[SP:Composant:Craft|craft]], qui permet de déployer pour le site en question du contenu par défaut.
Chaque siteClient contient des pages. Le contenu de chaque page est réparti par [[SP:Composant:Bloc|bloc]].
Chaque bloc contient des [[SP:Composant:BlocObject|blocObject]] de manière directe, cad chaque blocObject est lié par référence au bloc, ou de manière indirecte via les [[SP:Composant:PredefinedContent|predefinedContent]]. Ce sont alors les predefinedContent qui contiennent des BlocObject. Le predefinedContent n'est pas rélié a la page mais uniquement au bloc, ce qui permet de l'utiliser indépendamment de la page, et l'utiliser sur différentes pages.

SP:Processus:Gestion de contenu

2010-07-30T09:28:50Z

Sebd : /* Gestion de contenu */

[[Category:SP:Processus]]

= Gestion de contenu =

Diagramme montrant les différents composants agissant dans la gestion de contenu

[[Fichier:Composants_content.png]]

'''Legende''':

* contenu/fleches en vert: contenu utilisé pour afficher la version de production du contenu.
* contenu/fleches en orange: contenu utilisé sur la version éditeur
* contenu bleu: liaison non dépendante de la version du contenu utilisée (contenu de production/brouillon)

'''Explication'''

Un [[SP:Composant:SiteClient|site client]] est lié a un [[SP:Composant:Craft|craft]], qui permet de déployer pour le site en question du contenu par défaut.
Chaque siteClient contient des pages. Le contenu de chaque page est réparti par [[SP:Composant:Bloc|bloc]].
Chaque bloc contient des [[SP:Composant:BlocObject|blocObject]] de manière directe, cad chaque blocObject est lié par référence au bloc, ou de manière indirecte via les [[SP:Composant:PredefinedContent|predefinedContent]]. Certains bloc sont lié a des predefinedContent, qui eux contiennent des BlocObject.

SP:Processus:Gestion de contenu

2010-07-30T09:28:35Z

Sebd : /* Gestion de contenu */

[[Category:SP:Processus]]

= Gestion de contenu =

Diagramme montrant les différents composants agissant dans la gestion de contenu

[[Fichier:Composants_content.png]]

'''Legende''':

* contenu/fleches en vert: contenu utilisé pour afficher la version de production du contenu.
* contenu/fleches en orange: contenu utilisé sur la version éditeur
* contenu bleu: liaison non dépendante de la version du contenu utilisée (contenu de production/brouillon)

'''Explication'''

Un [[SP:Composant:SiteClient|site client]] est lié a un [[SP:Composant:Craft|craft]], qui permet de déployer pour le site en question du contenu par défaut.
Chaque siteClient contient des pages. Le contenu de chaque page est réparti par [[SP:Composant:Bloc|bloc]].
Chaque bloc contient des [[SP:Composant:BlocObjectblocObject]] de manière directe, cad chaque blocObject est lié par référence au bloc, ou de manière indirecte via les [[SP:Composant:PredefinedContent|predefinedContent]]. Certains bloc sont lié a des predefinedContent, qui eux contiennent des BlocObject.

SP:Processus:Gestion de contenu

2010-07-30T09:06:21Z

Sebd : /* Gestion de contenu */

SP:Processus:Gestion de contenu

2010-07-30T08:00:45Z

Sebd : an

SP:Processus:Gestion de contenu

2010-07-30T07:37:33Z

Sebd : /* Gestion de contenu */

[[Category:SP:Processus]]

= Gestion de contenu =

Diagramme montrant les différents composants agissant dans la gestion de contenu

[[Fichier:Composants_content.png]]

Fichier:Composants content.png

2010-07-30T07:37:19Z

Sebd :

SP:HowTo

2010-07-29T09:37:27Z

Sebd : /* Comment sont gérés les différentes partie sde l'application */

[[Category:Sites packagés]]

= 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? ===

* [[SP:Composant:BlocObject#Base_de_donn.C3.A9es_2|enregistrement en base]] du nouveau type
* enregistrement en base des [[SP:Composant:blocObjectValues|nouveaux type de valeurs]] associées à l'object
* création de sa classe php associée
* création des éventuels templates et controleyrs associés

Pour avoir le détail complet de chaque étape, rendez vous dans la section [[SP:Composant:BlocObject#D.C3.A9finition_des_types_de_blocObject|définition d'un blocObject]]

=== Comment ajouter un champ a un type de blocObject? ===

* ajout du champ dans la classe du type d'object ([[SP:Composant:BlocObject#Propri.C3.A9t.C3.A9s|section de manuel associée]])
* enregistrement de la clé du champ en base ([[SP:Composant:BlocObject#Propri.C3.A9t.C3.A9s|section de manuel associée]])
* modification du template et controleur associé si besoin ([[SP:Composant:BlocObject#Templates_et_controleurs_associ.C3.A9s|section associée]])

==== Exemple ====

''Je souhaiterais ajouter un nouveau champ qui permettent d'ajouter un champ de formulaire fax dans le type de blocObject "formulaire de contact"''

* ajout du champ permettant d'ajouter l'option de fax dans le formulaire de contact, dans la classe php associée '''BlocObjectContact''':
<pre>
'hasFax'=> array(
'type' => 'radio',
'label' => 'Fax',
'default' => 0, //pour la modification d'un type de blocObject déja existant, il est obligatoire d'ajouter une valeur par défaut, qui sera appliquée pour les blocObject de ce type déja existant
'inline' => true,
'options' => array(
1 => 'Oui',
0 => 'Non'
)
),
</pre>
* ajout du nouveau champ dans la liste des champs autorisé en base, dans la table '''valuesBlocObjectKey'''.
<pre>
INSERT INTO valuesBlocObjectKey(keyName) VALUES('hasFax');
</pre>
* modification du controleur et du template qui affiche ce type d'objet pour gérer ce nouveau paramètre, ici '''templates/cms/blocObjects/default/contact.php''' et '''controlers/cms/blocObjects/default/contact.php''' en utilisant la syntaxe '''$blocObject->values->hasFax''' pour savoir si l'utilisateur a choisi ou non d'afficher le champ fax dans son formulaire.
* reste a tester et à mettre en production, et c'est parti.

=== 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 [[SP:Composant:StyleProperties#d.C3.A9finition_des_conteneurs|les conteneurs]])
* Ajouter la propriété ([[SP:Composant:StyleProperties#Les_propri.C3.A9t.C3.A9s| 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 [[SP:Composant:StyleProperties#Cr.C3.A9ation_des_conteneurs|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:
<pre>
'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'
)

</pre>
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:
<pre>
$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
)
</pre>
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 [[SP:Composant:IncludeHandler#Configuration|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 [[SP:Composant:StyleProperties#La_sp.C3.A9cificit.C3.A9_MasterProperty|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.

=== Comment sont gérés les différentes partie sde l'application ===

Chaque partie de l'application est définie dans la classe '''models/Site.php'''. Un pattern permet d'identifier la partie concerné à partir de l'URL.
La page '''www/index.php''' récupère ensuite le type de l'application par le biais de la variable '''$site''', et procède aux traitement / redirections nécessaires, selon la partie appelée.

2010-07-29T08:29:58Z

Sebd : /* la classe ElementForm */

= Framework V2 =

Le framework V2 et la secodne version du framework développé par Hegyd, issue d'une refonte de la V1 effectuée en grande partie par Emmanuel Gautier.

== Fondements ==

=== la classe Element ===

Est étendu par bon nombre de classes de l'application. Elle permet de gérer automatiquement les fonctions de base d'un objet: enregistrement en base, récupération des valeurs, etc. Utilisée par presque toutes les classes crées pour l'éditeur.

Sa spécificité se trouve dans la définition des variables. Pour chaque objet, il est possible de définir l'ensemble des variables qui le compose, via la donnée membre '''$fields''' de la classe element. Voici un exemple de définition pour un élément:

<pre>
'nom_variable' => array(
'type'=> 'text', //type pour la conversion en tant qu'élément de formulaire
'storage'=> 'none' //indique si le champ a un champ associé en base (meme nom) ou non
)
</pre>

Chaque variable référencée est alors modifiable et accessible via '''$classe->nom_variable'''.

Pour enregistrer les variables en base, il suffit d'utiliser la fonction '''processAction()'''.

=== la classe ElementForm ===

Permet à partir d'un objet étendant Element de créer un formulaire permettant d'éditer l'ensemble des champs de l'object. La transformation est possible d'apres le type de l'object. Le parcours de la classe permet d'avoir un aperçu des différents type disponibles.

Dispose également de fonctions de validation, et gère l'enregistrement de fichiers a l'aide du composant [[SP:Composant:Upload|Upload]].

Voir [[http://admin.hegyd-developpement.com/documentation-chapitre-fiche.html?d_id=13&id=37|la doc Hegyd]] pour en savoir plus sur l'utilisation de ElementForm

Framework V2

2010-07-29T08:27:31Z

Sebd : /* Framework V2 */

Framework V2

2010-07-29T08:27:22Z

Sebd : /* la classe Element */

= Framework V2 =

Le framework V2 et la secodne version du framework développé par Hegyd, issue d'une refonte de la V1 effectuée en grande partie par Emmanuel Gautier.

== Arboresence ==

== Fondements ==

=== la classe Element ===

Est étendu par bon nombre de classes de l'application. Elle permet de gérer automatiquement les fonctions de base d'un objet: enregistrement en base, récupération des valeurs, etc. Utilisée par presque toutes les classes crées pour l'éditeur.

Sa spécificité se trouve dans la définition des variables. Pour chaque objet, il est possible de définir l'ensemble des variables qui le compose, via la donnée membre '''$fields''' de la classe element. Voici un exemple de définition pour un élément:

<pre>
'nom_variable' => array(
'type'=> 'text', //type pour la conversion en tant qu'élément de formulaire
'storage'=> 'none' //indique si le champ a un champ associé en base (meme nom) ou non
)
</pre>

Chaque variable référencée est alors modifiable et accessible via '''$classe->nom_variable'''.

Pour enregistrer les variables en base, il suffit d'utiliser la fonction '''processAction()'''.

=== la classe ElementForm ===

Permet à partir d'un objet étendant Element de créer un formulaire permettant d'éditer l'ensemble des champs de l'object. La transformation est possible d'apres le type de l'object. Le parcours de la classe permet d'avoir un aperçu des différents type disponibles.

Dispose également de fonctions de validation, et gère l'enregistrement de fichiers a l'aide du composant [[SP:Composant:Upload|Upload]].

SP:Composant:Upload

2010-07-29T08:09:04Z

Sebd : Page créée avec « Category:SP:Composants = Upload = Le composant Upload gère l'upload et le stockage des fichiers. La version utilisée est un dérivé du composant upload utilisé pou… »

[[Category:SP:Composants]]

= Upload =

Le composant Upload gère l'upload et le stockage des fichiers.
La version utilisée est un dérivé du composant upload utilisé pour le [[Framework_V2|framework V2]].

== Implémentation ==

=== base de données ===

* table '''Upload''':
** ''uploadId'': identifiant
** ''directory'': repertoire dans lequel se trouve le fichier
** ''id'': identifiant lié au fichier. Peut faire référence à un identifiant d'une autre table
** ''field'': champ permettant de définir le type d'upload
** ''source: nom du fichier
** ''extension'': extension du fichier
** ''description'': description du fichier
** ''size'': taille
** ''type'': type du fichier: fichier,image,film,audio (voir classe php Upload pour avoir les correspondance pour chaque type)
** ''infos'': infos du fichier
** ''ord'': non utilisé
** ''utsCreate'': date de création
** ''imageFotoliaId'': identifiant [[SP:Fotolia|fotolia]]

=== classe ===

classe '''Upload'''.

== Application à l'éditeur ==

=== Champ d'application à l'éditeur ===

* il est possible d'ajouter un fichier/ une image pour un blocObject, selon [[SP:Composant:BlocObject#Propri.C3.A9t.C3.A9s|les propriétés qui lui sont rattachées]].
* il est également possible d'ajouter des images dans [[SP:Composant:StyleProperties#Les_propri.C3.A9t.C3.A9s|les options de styles]].

Framework V2

2010-07-29T07:56:05Z

Sebd : Page créée avec « = Framework V2 = Le framework V2 et la secodne version du framework développé par Hegyd, issue d'une refonte de la V1 effectuée en grande partie par Emmanuel Gautier. =… »

Catégorie:Sites packagés

2010-07-29T07:19:42Z

Sebd : /* Sites packagés */

Attention : « Catégorie:Sites packagés » est référencé ici, mais vous ne disposez pas des autorisations pour y accéder.

2010-07-27T13:15:52Z

Sebd : /* Publication */

= blocObjectValuesDraft =

est un dérivé du composant [[SP:Composant:blocObjectValues|blocObjectValues]], représente sa forme éditable par l'utilisateur, son mode "brouillon".
Gère les champs et les valeurs associés aux [[SP:Composant:BlocObjectDraft|blocObjectDraft]], lui meme dérivé du composant [[SP:Composant:BlocObjectDraft|BlocObjectDraft]].

Pour chaque type de blocObjectDraft, un ensemble de fields est défini dans le tableau '''$valuesFields''' de la classe associé au blocObject. Ces champs et leurs valeurs sont gérés ici.

== Implémentation ==

=== base de données ===

* table '''valuesBlocObjectKey''': contient la liste des type de valeurs. A chaque création d'un nouveau blocObject, les champs qui le compose devront être référencé dans cette table.

** ''keyId'': identifiant
** ''keyName'': nom du type de la valeur

* table '''valuesBlocObjectDraft''':

** ''valuesBlocObjecDrafttId'': identifiant
** ''valuesBlocObjectId'': dans le cas ou la valeur est la version de brouillon d'une valeur existante, on indique ici l'identifiant de la valeur de production
** ''keyId'': type de valeur (voir types de valeurs)
** ''blocObjectId'': dans le cas ou la valeur est la version de brouillon d'une valeur existante, référence ici le blocObject associé
** ''blocObjectDraftId'': blocObjectDraft lié
** ''value'': valeur associée
** ''table'': table dans laquelle se trouve la valeur (non utilisé). Le chap précédent valeur contiendrait alors l'identifiant de la vvaleur pour la table. Utile pour les valeurs complexes, qui ne se résument pas à une chaine de caractère.
** ''utsCreate'': date de création
** ''utsUpdate'': date de modification

=== Classe ===

Classe: '''blocObjectDraftValues'''.

== Publication / Annulation ==

=== Publication ===

La publication des champs et valeurs d'un blocObject et étroitement liée au blocObjectDraft. C'est via [[SP:Composant:BlocObjectDraft#Publication|la fonction de publication]] du blocObject qu'est réalisé celle de ses valeurs.

=== Annulation ===

L'annulation des champs et valeurs d'un blocObject et étroitement liée au blocObject. C'est via [[SP:Composant:BlocObject#Annulation|la fonction d'annulation]] du blocObject qu'est réalisé celle de ses valeurs.

SP:Composant:blocObjectValuesDraft

2010-07-27T13:15:21Z

Sebd : /* Publication / Annulation */

= blocObjectValuesDraft =

est un dérivé du composant [[SP:Composant:blocObjectValues|blocObjectValues]], représente sa forme éditable par l'utilisateur, son mode "brouillon".
Gère les champs et les valeurs associés aux [[SP:Composant:BlocObjectDraft|blocObjectDraft]], lui meme dérivé du composant [[SP:Composant:BlocObjectDraft|BlocObjectDraft]].

Pour chaque type de blocObjectDraft, un ensemble de fields est défini dans le tableau '''$valuesFields''' de la classe associé au blocObject. Ces champs et leurs valeurs sont gérés ici.

== Implémentation ==

=== base de données ===

* table '''valuesBlocObjectKey''': contient la liste des type de valeurs. A chaque création d'un nouveau blocObject, les champs qui le compose devront être référencé dans cette table.

** ''keyId'': identifiant
** ''keyName'': nom du type de la valeur

* table '''valuesBlocObjectDraft''':

** ''valuesBlocObjecDrafttId'': identifiant
** ''valuesBlocObjectId'': dans le cas ou la valeur est la version de brouillon d'une valeur existante, on indique ici l'identifiant de la valeur de production
** ''keyId'': type de valeur (voir types de valeurs)
** ''blocObjectId'': dans le cas ou la valeur est la version de brouillon d'une valeur existante, référence ici le blocObject associé
** ''blocObjectDraftId'': blocObjectDraft lié
** ''value'': valeur associée
** ''table'': table dans laquelle se trouve la valeur (non utilisé). Le chap précédent valeur contiendrait alors l'identifiant de la vvaleur pour la table. Utile pour les valeurs complexes, qui ne se résument pas à une chaine de caractère.
** ''utsCreate'': date de création
** ''utsUpdate'': date de modification

=== Classe ===

Classe: '''blocObjectDraftValues'''.

== Publication / Annulation ==

=== Publication ===

La publication des champs et valeurs d'un blocObject et étroitement liée au blocObject. C'est via [[SP:Composant:BlocObject#Publication|la fonction de publication]] du blocObject qu'est réalisé celle de ses valeurs.

=== Annulation ===

L'annulation des champs et valeurs d'un blocObject et étroitement liée au blocObject. C'est via [[SP:Composant:BlocObject#Annulation|la fonction d'annulation]] du blocObject qu'est réalisé celle de ses valeurs.

SP:Composant:blocObjectValuesDraft

2010-07-27T09:33:22Z

Sebd : /* Publication / Annulation */

SP:Composant:blocObjectValuesDraft

2010-07-27T09:24:50Z

Sebd : /* blocObjectValuesDraft */

SP:Composant:blocObjectValuesDraft

2010-07-27T09:24:26Z

Sebd : /* Implémentation */

2010-07-27T09:03:45Z

Sebd : /* BlocObjectDraft */

[[Category:SP:Composants]]

= BlocObjectDraft =

Un BlocObjectDraft est la version brouillon d'un [[SP:Composant:BlocObject|BlocObject]] ([[SP:Définitions|voir le process de brouillon/publication]]).
Il peut avoir des [[SP:Composant:BlocObjectValuesDraft|valeurs]] associées.

A l'inverse du [[SP:Composant:BlocObject|BlocObject]], seul un BlocObjectDraft peut être transformé en formulaire, pour modifier ses [[SP:Composant:BlocObjectValuesDraft|valeurs]].

Et seul le blocObjectDraft peut être publié. Un blocObject est la version publié d'un blocObjectDraft.

== Implementation ==

=== Base de données ===

Table '''BlocObjectDraftId''':

* ''blocObjectDraftId'': identifiant
* ''pageSiteClientId'': identifiant de page
* ''position'': position du blocObject parmi ceux se trouvant a l'intérieur du même [[SP:Composant:Bloc|bloc]].
* ''customPosition'': flag indiquant si l'object sera positionné a la main dans le code (les métas, directement intégrées dans le header), ou de façon automatique par le biais de sa position et du bloc auquel il appartient.
* ''typeBlocObjectId'': type du blocObject (référence a l'identifiant de la table '''typeBlocObjectId''').
* ''typeBlocId'': bloc dans lequel se trouve le blocObject.
* ''interactiveEdit'': autorise la modification au passage sur l'élément dans l'interface (reprend par défaut la valeur du type de blocObject associé)
* ''isEditable'': flag indiquant si l'object est éditable par l'utilisateur (reprend par défaut la valeur du type de blocObject associé)
* ''isDraggable'': flag indiquant si le blocObject est déplacable opar l'utilisateur (reprend par défaut la valeur du type de blocObject associé)
* ''isDeleteable'': flag indiquant si le blocObject peut être supprimé par l'utlisateur (reprend par défaut la valeur du type de blocObject associé)
* ''activated'': flag indiquant si le blocObject est activé (visible pour l'utilisateur) (reprend par défaut la valeur du type de blocObject associé)
* ''hasValues'': indique si le blocObject peut avoir des [[SP:Composant:blocObjectValues|valeurs associées]].
* ''predefinedContentId'': identifiant du [[SP:Composant:PredefinedContent|contenu prédéfini]] associé au blocObject, si c'est le cas.
* ''utsCreate'': date de création
* ''utsUpdate'': date de modification
* ''utsDelete'': date de suppression (non utilisé, lorsqu'un blocObject est supprimé, sa ligne en base l'est également).
* ''status'': indique si le blocObjectDraft est en mode édition ou suppression (dans le cas d'une suppression, la publication supprimera l'objet).
* ''blocObjectId'': dans le cas ou l'object dérive d'un blocObject (cas de modification d'un blocObject publié dans l'éditeur par exemple, [[SP:Définitions|voir le processus de publication]]).

=== Classe ===

La classe '''BlocObjectDraft''' permet de gérer les blocObjectDraft.

== Publication / Annulation ==

=== Publication ===

Lors de la publication, le blocObjectDraft est transformé en blocObject: si le draft est lié a un blocObject existant, alors on remplace les infos du blocObject existant par celles du draft. Si aucun blocObject n'est lié, alors on en crée un nouveau.
On [[SP:Composant:blocObjectDraftValues#Publication|publie ensuite les valeurs des champs associés]] au blocObjectDraft.
Le blocObjectDraft est ensuite détruit.

Voir la méthode '''publish()''' de la classe de l'objet.

=== Annulation ===

Le blocObjectdraft est détruit ainsi que [[SP:Composant:BlocObjectDraftValues#Annulation|ses valeurs]].

Voir la méthode '''destroy()''' de la classe de l'objet.