User API guide/fr: Difference between revisions

Line 147:

~~<div lang="en" dir="ltr" class="mw-content-ltr">~~

L'étape suivante pour un client consiste à choisir une date et une heure pour son service. Nous avons utilisé un sélecteur de date Bootstrap dans l'exemple d'utilisation de l'API, mais vous pouvez également utiliser celui-ci ou tout autre calendrier. Pour définir la première date de votre calendrier, utilisez la méthode getFirstWorkingDay. Elle peut prendre l'identifiant de l'employé comme paramètre et renvoie la prochaine date à laquelle l'employé sélectionné (ou tout employé de l'entreprise par défaut) est disponible pour une réservation. Pour afficher les créneaux horaires disponibles à une date sélectionnée, vous devez utiliser les méthodes getWorkCalendar et getStartTimeMatrix. La première méthode vous donne des informations sur les heures de début et de fin des jours ouvrables, ainsi que sur les jours fériés. La seconde renvoie la liste des créneaux horaires pouvant être réservés pour une date donnée.

~~The next step to a~~ client ~~is to pick a~~ date ~~and time of his~~ service. We'~~ve used a Bootstrap date-picker in~~ API-~~usage example, you can also use this or any other calendar~~. ~~To set your calendar first~~ date ~~use~~ getFirstWorkingDay ~~method~~. ~~It can take employee id as a parameter and returns the next~~ date ~~when the selected employee~~ (~~or any employee in the company by default~~) ~~is avaiable for booking~~. ~~To show time slots inside a selected~~ date ~~you need~~ getWorkCalendar ~~and~~ getStartTimeMatrix ~~methods~~. ~~The first method give you an information about working day start and end time~~, ~~and about day-offs~~. ~~And the second one returns the list of time-slots which can be booked for a certain~~ date.

'''~~Code example of getting work days info~~'''

'''Exemple de code pour obtenir des informations sur les jours ouvrables'''

~~</div>~~

~~<div lang="en" dir="ltr" class="mw-content-ltr">~~

<nowiki>$année = 2015 ;

<nowiki>$~~year~~ = 2015;

$mois = 3 ; // mars

$~~month~~ = 3; // ~~March~~

$performerId = 1 ; // Peut être nul

$performerId = 1; // ~~Can be null~~

$workDaysInfo = $client->getWorkCalendar($année, $mois, $performerId) ;

$workDaysInfo = $client->getWorkCalendar($~~year~~, $~~month~~, $performerId);

// renvoie array(

// ~~returns~~ array(

// '2015-03-01' => array('from' => '09:00:00', 'to' => '18:00:00', 'is_day_off' => 0),

// '2015-03-02' => array('from' => '09:00:00', 'to' => '18:00:00', 'is_day_off' => 0),

// ...

//);</nowiki>

'''~~Code example of getting start time matrix~~'''

'''Exemple de code pour obtenir la matrice des heures de début'''

<nowiki>$dateFrom = '2015-03-03';

Line 172:

Line 169:

$performerId = 1;

$qty = 1;

$availableTime = $client->getStartTimeMatrix($dateFrom, $dateTo, $serviceId, $performerId, $qty);

// ~~returns~~ array(

// renvoie array(

// '2015-03-03' => array('09:00:00', '09:30:00', '10:00:00', ....),

// '2015-03-04' => array('09:00:00', '09:30:00', '10:00:00', ....),

//);</nowiki>

~~</div>~~

@@ Line 147: / Line 147: @@
 <br><br>
-<div lang="en" dir="ltr" class="mw-content-ltr">
+L'étape suivante pour un client consiste à choisir une date et une heure pour son service. Nous avons utilisé un sélecteur de date Bootstrap dans l'exemple d'utilisation de l'API, mais vous pouvez également utiliser celui-ci ou tout autre calendrier. Pour définir la première date de votre calendrier, utilisez la méthode getFirstWorkingDay. Elle peut prendre l'identifiant de l'employé comme paramètre et renvoie la prochaine date à laquelle l'employé sélectionné (ou tout employé de l'entreprise par défaut) est disponible pour une réservation. Pour afficher les créneaux horaires disponibles à une date sélectionnée, vous devez utiliser les méthodes getWorkCalendar et getStartTimeMatrix. La première méthode vous donne des informations sur les heures de début et de fin des jours ouvrables, ainsi que sur les jours fériés. La seconde renvoie la liste des créneaux horaires pouvant être réservés pour une date donnée.
-The next step to a client is to pick a date and time of his service. We've used a Bootstrap date-picker in API-usage example, you can also use this or any other calendar. To set your calendar first date use getFirstWorkingDay method. It can take employee id as a parameter and returns the next date when the selected employee (or any employee in the company by default) is avaiable for booking. To show time slots inside a selected date you need getWorkCalendar and getStartTimeMatrix methods. The first method give you an information about working day start and end time, and about day-offs. And the second one returns the list of time-slots which can be booked for a certain date.
 <br><br>
-'''Code example of getting work days info'''
+'''Exemple de code pour obtenir des informations sur les jours ouvrables'''
 <br><br>
-</div>
-  <div lang="en" dir="ltr" class="mw-content-ltr">
+  <nowiki>$année = 2015 ;
-<nowiki>$year = 2015;
+$mois = 3 ; // mars
-$month = 3; // March
+$performerId = 1 ; // Peut être nul
-$performerId = 1; // Can be null
+$workDaysInfo = $client-&gt;getWorkCalendar($année, $mois, $performerId) ;
-$workDaysInfo = $client->getWorkCalendar($year, $month, $performerId);
+// renvoie array(
-// returns array(
+//     '2015-03-01' =&gt; array('from' =&gt; '09:00:00', 'to' =&gt; '18:00:00', 'is_day_off' =&gt; 0),
-//     '2015-03-01' => array('from' => '09:00:00', 'to' => '18:00:00', 'is_day_off' => 0),
+//     '2015-03-02' =&gt; array('from' =&gt; '09:00:00', 'to' =&gt; '18:00:00', 'is_day_off' =&gt; 0),
-//     '2015-03-02' => array('from' => '09:00:00', 'to' => '18:00:00', 'is_day_off' => 0),
 //     ...
 //);</nowiki>
 <br><br>
-'''Code example of getting start time matrix'''
+'''Exemple de code pour obtenir la matrice des heures de début'''
 <br><br>
   <nowiki>$dateFrom = '2015-03-03';
@@ Line 172: / Line 169: @@
 $performerId = 1;
 $qty = 1;
-$availableTime = $client->getStartTimeMatrix($dateFrom, $dateTo, $serviceId, $performerId, $qty);
+$availableTime = $client-&gt;getStartTimeMatrix($dateFrom, $dateTo, $serviceId, $performerId, $qty);
-// returns array(
+// renvoie array(
-//     '2015-03-03' => array('09:00:00', '09:30:00', '10:00:00', ....),
+//     '2015-03-03' =&gt; array('09:00:00', '09:30:00', '10:00:00', ....),
-//     '2015-03-04' => array('09:00:00', '09:30:00', '10:00:00', ....),
+//     '2015-03-04' =&gt; array('09:00:00', '09:30:00', '10:00:00', ....),
 //);</nowiki>
 <br><br>
-</div>
 <div lang="en" dir="ltr" class="mw-content-ltr">