Events Made Easy Frontend Submit

FAQ

Comment/où puis-je modifier la mise en page du formulaire ?

L’extension recherchera les modèles de formulaires et les fichiers de style dans les chemins suivants, selon cette priorité :

1. Répertoire UPLOAD de WordPress/events-made-easy-frontend-submit/
2. ./wp-content/themes/votre thème actuel/eme-frontend-submit/
3. ./wp-content/themes/votre thème actuel/events-made-easy-frontend-submit/
4. ./wp-content/themes/votre thème actuel/emefs/
5. ./wp-content/themes/votre thème actuel/events-made-easy/

Les fichiers surchargeables en ce moment sont :

1. form.php qui contrôle le formulaire html. La version par défaut se trouve dans le sous-répertoire templates.↵
   Si vous souhaitez modifier la mise en page (la version par défaut ne vous conviendra très probablement pas), copiez ce fichier dans, par exemple, WP UPLOAD DIR/events-made-easy-frontend-submit/ et modifiez le contenu à cet endroit.↵
   Ne modifiez pas le fichier par défaut dans le sous-répertoire templates, il sera écrasé lors de la prochaine mise à jour du plugin.
2. style.css qui contrôle le style chargé automatiquement par l’extension. La version par défaut se trouve dans le sous-dossier templates.

Pour permettre l’utilisation de plusieurs formulaires, vous pouvez ajouter une option au code court pour indiquer le nom du modèle de formulaire (par défaut : form.php).
Exemple : [emefs_submit_event_form template=test.php]
Si votre modèle n’est pas trouvé dans l’un des 4 endroits mentionnés ci-dessus, les modèles se trouvant dans templates/form.php seront pris par défaut

Quels champs puis-je utiliser dans le formulaire ?

Comme indiqué dans les exemples de modèles, vous appelez EMEFS::champ (‘xxx’) avec « xxx » étant l’une des options suivants:
event_name
event_status
event_category_ids
event_start_date
event_start_time
event_end_date
event_end_time
event_notes
event_contactperson_email_body
event_respondent_email_body
event_url
event_rsvp
registration_requires_approval
registration_wp_users_only
event_image_url
event_seats
price
location_name
location_address1
location_address2
location_city
location_state
location_zip
location_country
location_latitude
location_longitude

Pour tous les champs possibles, regardez dans eme_events.php, fonction eme_new_event.↵
Si vous avez activé l’option pour utiliser le captcha, vous pouvez (devez) également utiliser le champ ‘captcha’↵.
Si vous avez activé l’option pour utiliser le reCAPTCHA de Google, vous pouvez (devez) également utiliser le champ ‘recaptcha’↵
Si vous avez activé l’option pour utiliser hCaptcha, vous pouvez (devez) également utiliser le champ ‘hcaptcha’.

Qu’en est-il des attributs supplémentaires ?

Eh bien, en fait c’est plus facile que prévu. Juste en utilisant
EMEFS::attribute(‘phone2’)
Dans le modèle de formulaire, l’attribut phone2 est disponible et peut être utilisé dans un modèle d’évènement via #_ATT {phone2}
Par défaut, le type de formulaire pour les attributs est zone de texte. Si vous voulez un champ de texte brut, utilisez par exemple :
EMEFS::attribute(‘phone2′,’text’)

Que diriez-vous des propriétés d’évènements supplémentaires

De nombreuses options d’évènement plus récentes sont stockées dans les propriétés, voir la fonction eme_init_event_props () dans le fichier eme_events.php pour une liste complète.
Une petite énumération :
auto_approve ()
ignore_pending ()
all_day ()
take_attendance ()
min_allowed
max_allowed
rsvp_end_target
rsvp_discount
rsvp_discountgroup
use_worldpay ()
use_stripe ()
use_braintree (*)

Vous pouvez les utiliser comme ceci : EMEFS::property(‘xxx’);
Pour ceux marqués avec (*), utilisez l’option binaire supplémentaire : EMEFS::property(‘xxx’,’binary’);

Que diriez-vous des champs d’évènement ou d’emplacement personnalisés ?

If you have defined custom fields of type Events or Locations in EME, they are part of the event or location definition.
In that case, you can also ask in the frontend for that info, by using EMEFS::custom_field(‘xxx’). ‘xxx’ can be the id or the fieldname.
Example (under the assumption ‘my_price’ is a custom event or location field):
Example (under the assumption ’15’ is a custom event or location field):
Example (under the assumption ’15’ is a custom event or location field):

Quels types de champs sont pris en charge ?

EMEFS::attribute, EMEFS::property and EMEFS::field can have a second argument, indicating the type of your field of choice:
Example:
Example:
The different types supported: textarea (default), text, hidden, tel, url, email and number
Also the event_url regular field entry can have the url-html5 option:

Champ binaire (OUI/NON)

Si vous souhaitez afficher un champ en tant que sélection du menu déroulant, utilisez comme deuxième option (pour le type) la valeur ‘binary’
par exemple. EMEFS::property(‘all_day’,’binary’)

Champs obligatoires

Si vous souhaitez qu’un champ soit requis (sinon par défaut), utilisez EMEFS::required_field(‘xxx’)
Pour les attributs requis, utilisez EMEFS::required_attribute(‘xxx’)
Pour les propriétés requises, utilisez EMEFS::required_property(‘xxx’)

Valeurs par défaut et classes supplémentaires

Si vous souhaitez utiliser une valeur par défaut pour certains attributs ou propriétés, vous pouvez utiliser un troisième paramètre pour EMEFS::field, EMEFS::attribute et EMEFS::property.
Par exemple, EMEFS::property(‘event_single_event_format_tpl’, ‘hidden’, « value=2 ») ;
Ce troisième paramètre peut également être utilisé pour ajouter des styles personnalisés etc … :
Par exemple, EMEFS::property(‘event_single_event_format_tpl’, ‘hidden’, « value=2 class=’my_class' ») ;

Filtres et actions

Action emefs_submit_event_action : autorise une action personnalisée après la soumission de l’évènement (comme l’envoi d’un e-mail aux personnes concernées).
(voir l’action eme_insert_event_action dans l’extension EME principal comme exemple).
Filtre emefs_categories_filter : pour filtrer les catégories, voir aussi eme_categories_filter
Filtre emefs_event_insert_filter : exécuté juste avant l’insertion du nouvel évènement dans la base de données (vous pouvez donc modifier certaines propriétés par défaut). Voir aussi eme_insert_event_filter
Filtre emefs_success_url : prend la page de succès actuelle comme paramètre et doit retourner une nouvelle url. Cela vous autorise à modifier la page de succès par évènement soumis.