From 106c3541154ec93e83a3506772355fb9707cde6f Mon Sep 17 00:00:00 2001 From: Office GSX Date: Wed, 5 Sep 2018 10:34:08 +0200 Subject: [PATCH] update of the readme files --- README-Localized/README-de-de.md | 58 +++++++++++++++++--------------- README-Localized/README-es-es.md | 58 +++++++++++++++++--------------- README-Localized/README-fr-fr.md | 58 +++++++++++++++++--------------- README-Localized/README-ja-jp.md | 58 +++++++++++++++++--------------- README-Localized/README-pt-br.md | 58 +++++++++++++++++--------------- README-Localized/README-ru-ru.md | 58 +++++++++++++++++--------------- README-Localized/README-zh-cn.md | 58 +++++++++++++++++--------------- README-Localized/README-zh-tw.md | 58 +++++++++++++++++--------------- 8 files changed, 248 insertions(+), 216 deletions(-) diff --git a/README-Localized/README-de-de.md b/README-Localized/README-de-de.md index de65bbe..3ce91c0 100644 --- a/README-Localized/README-de-de.md +++ b/README-Localized/README-de-de.md @@ -1,42 +1,46 @@ -# UX-Entwurfsmuster für Office-Add-Ins +# Beispiel für PHP-Kalender-API # -Dieses Repository bietet Beispielimplementierungen von allgemeinen UX-Entwurfsmustern für Office Add-Ins in HTML-, CSS- und JavaScript-Code. +[日本 (日本語)](https://github.com/jasonjoh/php-calendar/blob/master/loc/readme-ja.md) (Japanisch) -Beim Entwerfen von Office-Add-Ins sollte das UX-Design des Add-Ins eine überzeugende Leistung bieten, durch die Office erweitert wird. Das Add-In sollte beispielsweise unter anderem eine Anpassung für das erste Ausführen, eine herausragende UX-Erfahrung sowie nahtlose Übergänge zwischen Seiten bieten. Eine übersichtliche und moderne UX-Funktionalität steigert die Benutzerbindung und die Akzeptanz Ihres Add-Ins. Dieses Repository stellt UX-Ressourcen für Entwickler dar, die Folgendes implementieren: +In diesem Beispiel wird gezeigt, wie Sie die [Kalender-API](https://msdn.microsoft.com/office/office365/APi/calendar-rest-operations) von PHP verwenden. Die Beispiel-App ist eine App für „kommende Vorstellungen“ bei einem Shakespeare-Festival eines fiktiven Laientheaters. Benutzer können ihre Office 365-Konten mit dem Kalender verbinden und Veranstaltungen für die Shows hinzufügen, die sie sich ansehen. Der Benutzer hat die Möglichkeit, Freunde einzuladen, wodurch jeder eingeladene Freund eine Besprechungsanfrage erhält. -* Allgemeine UX-Entwurfsmuster basierend auf bewährten Methoden -* Office-Fabric-Komponenten und -Formen -* Add-Ins, die wie eine natürliche Erweiterung der standardmäßigen Office-Benutzeroberfläche aussehen +## Verwendete API-Funktionen ## -Allgemeine Informationen sowie Informationen zu den verfügbaren Typen von UX-Entwurfsmustern finden Sie unter [UX-Entwurfsmustervorlagen für Office-Add-Ins](https://dev.office.com/docs/add-ins/design/ux-design-patterns). +- Erstellen von Ereignissen im Standardkalender eines Benutzers +- Hinzufügen von Anlagen zu Ereignissen +- Hinzufügen von Teilnehmern zu Ereignissen +- Verwenden einer [Kalenderansicht](https://msdn.microsoft.com/office/office365/APi/calendar-rest-operations#GetCalendarView) zum Erweitern der Ereignisserien und zum Anzeigen aller Termine für einen einzelnen Tag. -> Wichtig: Nach Anpassung dieser Entwurfsmuster an ihre Anforderungen müssen Sie das Add-In auf allen Plattformen testen, auf denen das Add-In verfügbar sein soll. Diese UX-Entwurfsmuster wurden mithilfe von Office 2016 und Windows 10 getestet. +## Erforderliche Software ## -## Verwenden der UX-Entwurfsmuster +- [PHP 5.6](http://php.net/downloads.php) +- Ein PHP-fähiger Webserver. -Sie können die [UX-Entwurfsspezifikationen](https://github.com/OfficeDev/Office-Add-in-UX-Design-Patterns) als Hilfe beim Erstellen Ihres eigenen UX-Entwurfs verwenden, oder Sie können den [Quellcode](https://github.com/OfficeDev/Office-Add-in-UX-Design-Patterns-Code/tree/master/templates) direkt zu Ihrem Projekt hinzufügen. So fügen Sie den Quellcode hinzu +Bei meinen Tests habe ich IIS 8 auf einem Windows 8.1-Laptop verwendet. Ich habe PHP 5.6.0 mithilfe des [Webplattform-Installers](http://www.microsoft.com/web/downloads/platform.aspx) (nur Windows/IIS) installiert. -1. Klonen Sie dieses Repository. -2. Kopieren Sie den [Objektordner](https://github.com/OfficeDev/Office-Add-in-UX-Design-Pattern-Code/tree/master/assets) und den Codeordner für das einzelne Muster, das Sie für Ihr Add-In-Projekt ausgewählt haben. -3. Integrieren Sie das einzelne Muster in Ihr Add-In. Beispiel: - - Bearbeiten Sie den Quellspeicherort oder die Add-In-Befehls-URL im Manifest. - - Verwenden Sie das UX-Entwurfsmuster als Vorlage für andere Seiten. - - Stellen Sie eine Verknüpfung zu oder von dem UX-Entwurfsmuster her. +## Ausführen des Beispiels ## -## Bekannte Probleme +Es wird davon ausgegangen, dass Sie PHP installiert haben, bevor Sie beginnen, und dass Ihr Webserver zur Verarbeitung von PHP-Dateien konfiguriert ist. -* Beim Ausführen einiger Codedateien außerhalb eines Add-In-Projekts wird ein JavaScript-Fehler ausgelöst. - * Lösung: Stellen Sie sicher, dass Sie diese Dateien einem Office-Add-In-Projekt hinzugefügt haben. -* Nach der Konvertierung dieser Entwurfsmuster in eine Einzelseiten-App (SPA) werden alle Abschnitte der HTML-Seite oben ausgerichtet, sodass es zu einer Überschneidung kommt. - * Lösung: Beim Konvertieren von HTML-Code werden möglicherweise zusätzliche Wrapper-DIV-Elemente hinzugefügt. Stellen Sie sicher, dass die Höhe dieser zusätzlichen DIV-Elemente ordnungsgemäß zurückgesetzt wird. Wenn ein übergeordnetes DIV-Element auf eine Höhe von 100 % festgelegt ist , ein untergeordnetes DIV-Element über keine Höhe verfügt und ein zwei Ebenen untergeordnetes DIV-Element auf 100 % festgelegt ist, müssen Sie das untergeordnete DIV-Element auf 100 % festlegen, damit die Abschnitte ordnungsgemäß angeordnet werden. - -## Weitere Ressourcen +1. Laden Sie das Beispielprojekt herunter. +1. Erstellen Sie ein neues Verzeichnis in Ihrem Webstammverzeichnis mit dem Namen `php-calendar`. Kopieren Sie die Dateien aus dem Repository in dieses Verzeichnis. +1. [Registrieren Sie die Anwendung in Azure Active Directory](https://github.com/jasonjoh/office365-azure-guides/blob/master/RegisterAnAppInAzure.md). Die App sollte als Web-App mit der Anmelde-URL `http://localhost/php-calendar` registriert werden und sollte die Berechtigung für Vollzugriff auf die Benutzerkalender haben, die im Dropdown „Delegierte Berechtigungen“ verfügbar ist. +1. Bearbeiten Sie die Datei `.\o365\ClientReg.php`. + 1. Kopieren Sie die Client-ID für Ihre App, die Sie bei der App-Registrierung abgerufen haben, und kopieren Sie diese als den Wert für die `$clientId`-Variable. + 1. Kopieren Sie den bei der App-Registrierung erstellten Schlüssel, und kopieren Sie ihn als den Wert für die `$clientSecret`-Variable. + 1. Speichern Sie die Datei. +1. Wenn Ihre PHP-Installation nicht mit aktualisierten Zertifizierungsstellenzertifikaten zur Überprüfung von SSL konfiguriert ist, schlagen Anfragen fehlt, es sei denn, Sie führen Fiddler auf dem Server aus, und legen die `$enableFiddler`-Variable auf `true` in `Office365Service.php` fest. Alternativ können Sie die folgende Zeile unmittelbar vor dem Aufruf von `curl_exec` einfügen. Beachten Sie **jedoch**, dass dadurch alle SSL-Überprüfungen deaktiviert werden, was in der Produktion NICHT zu empfehlen ist. -* [Bewährte Methoden für die Entwicklung von Office-Add-Ins](https://dev.office.com/docs/add-ins/overview/add-in-development-best-practices) -* [Office UI Fabric](http://dev.office.com/fabric/). Dieses Projekt verwendet Version 2.1.0 oder höher. + curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, 0); +1. Öffnen Sie einen Webbrowser, und navigieren Sie zu `http://localhost/php-calendar/home.php`. +1. Es sollte eine Liste kommender Vorstellungen für verschiedene Shakespeare-Stücke zu sehen sein. Klicken Sie auf eine der Schaltflächen „Meinen Kalender verbinden“, um sich bei Office 365 anzumelden. +1. Nach der Anmeldung sollten Sie zurück zur Startseite geleitet werden, und die Schaltflächen heißen nun „Zum Kalender hinzufügen“. Klicken Sie auf die Schaltfläche neben einer bestimmten Vorstellung, um diese zu Ihrem Kalender hinzuzufügen. Veranstaltungen, bei denen das Feld „Eintrittskarte erforderlich“ auf „Ja“ festgelegt ist, umfassen die Eintrittskarte als Anlage zu der Veranstaltung. -In diesem Projekt wurden die [Microsoft Open Source-Verhaltensregeln](https://opensource.microsoft.com/codeofconduct/) übernommen. Weitere Informationen finden Sie unter [Häufig gestellte Fragen zu Verhaltensregeln](https://opensource.microsoft.com/codeofconduct/faq/), oder richten Sie Ihre Fragen oder Kommentare an [opencode@microsoft.com](mailto:opencode@microsoft.com). +## Copyright ## -Copyright (c) Microsoft Corporation 2016. Alle Rechte vorbehalten. +Copyright (c) Microsoft. Alle Rechte vorbehalten. +---------- +Kontaktieren Sie mich auf Twitter unter [@JasonJohMSFT](https://twitter.com/JasonJohMSFT) +Folgen Sie dem [Exchange Dev Blog](http://blogs.msdn.com/b/exchangedev/) \ No newline at end of file diff --git a/README-Localized/README-es-es.md b/README-Localized/README-es-es.md index 21ef0cc..4263674 100644 --- a/README-Localized/README-es-es.md +++ b/README-Localized/README-es-es.md @@ -1,42 +1,46 @@ -# Modelos de diseño de la experiencia de usuario para complementos de Office +# Ejemplo de la API de calendario de PHP # -Este repositorio proporciona implementaciones de ejemplo en HTML, CSS y JavaScript de patrones de diseño comunes de experiencia del usuario para los complementos de Office. +[日本 (日本語)](https://github.com/jasonjoh/php-calendar/blob/master/loc/readme-ja.md) (japonés) -Al diseñar complementos de Office, hay que procurar que la experiencia del usuario del complemento sea atractiva y que amplíe las funciones de Office. Por ejemplo, este debe tener una experiencia de primera ejecución, ofrecer una experiencia del usuario de primera clase y facilitar una transición suave entre las páginas, entre otras cosas. Una experiencia del usuario moderna y sin complicaciones aumenta la retención de usuarios y la adopción del complemento. En este repositorio hay recursos para desarrolladores que implementan: +En este ejemplo se muestra cómo se puede usar la [API de calendario](https://msdn.microsoft.com/office/office365/APi/calendar-rest-operations) de PHP. La aplicación de ejemplo es una aplicación de "próximos programas" para un festival de Shakespeare de un teatro ficticio de la comunidad. Los usuarios pueden conectarse a su cuenta de Office 365 y agregar eventos a su calendario sobre las sesiones a las que asistirán. El usuario tiene la opción de invitar a sus amigos, lo que hará que se envíe una convocatoria de reunión a cada amigo invitado. -* Modelos de diseño de la experiencia del usuario comunes basados en procedimientos recomendados. -* Componentes y estilos de Office Fabric. -* Complementos que parecen una extensión natural de la interfaz de usuario predeterminada de Office. +## Características de la API utilizadas ## -Para obtener información general y los tipos de modelos de diseño de la experiencia del usuario disponibles, consulte [Modelos de diseño de la experiencia del usuario para complementos de Office](https://dev.office.com/docs/add-ins/design/ux-design-patterns). +- Crear eventos en el calendario predeterminado de un usuario +- Agregar datos adjuntos a eventos +- Agregar asistentes a eventos +- Se usa una [vista Calendario](https://msdn.microsoft.com/office/office365/APi/calendar-rest-operations#GetCalendarView) para expandir los eventos periódicos y mostrar todas las citas para un solo día. -> Importante: Tras personalizar estos patrones de diseño para que cumplan los requisitos, asegúrese de probar el complemento en todas las plataformas en las que estará disponible. Estos patrones de diseño de experiencia del usuario se han probado con Office 2016 y Windows 10. +## Software necesario ## -## Usar los modelos de diseño de la experiencia del usuario +- [PHP 5.6](http://php.net/downloads.php) +- Un servidor web capaz de proporcionar PHP. -Puede usar las [especificaciones de diseñadores de la experiencia del usuario](https://github.com/OfficeDev/Office-Add-in-UX-Design-Patterns) como guía a la hora de crear su propio diseño de la experiencia del usuario o puede agregar el [código fuente](https://github.com/OfficeDev/Office-Add-in-UX-Design-Patterns-Code/tree/master/templates) directamente al proyecto. Para agregar el código fuente: +En mi prueba, usé IIS 8 instalado en un portátil con Windows 8.1. Instalé PHP versión 5.6.0 a través del [instalador de la plataforma web](http://www.microsoft.com/web/downloads/platform.aspx) (solo Windows/IIS). -1. Clone este repositorio. -2. Copie la [carpeta de recursos](https://github.com/OfficeDev/Office-Add-in-UX-Design-Pattern-Code/tree/master/assets) y la carpeta de código del modelo individual que elija en su proyecto de complemento. -3. Incorpore el modelo individual al complemento. Por ejemplo: - - Edite la ubicación de origen o la URL del comando en el manifiesto. - - Use el modelo de diseño de la experiencia del usuario como modelo para otras páginas. - - Cree vínculos al modelo de diseño de la experiencia del usuario o desde este. +## Ejecución del ejemplo ## -## Problemas conocidos +Se supone que tiene PHP instalado antes de comenzar y que el servidor web está configurado para procesar y proporcionar archivos PHP. -* Al ejecutar algunos archivos de código fuera de un proyecto de complemento, se muestra un error de JavaScript. - * Solución: Asegúrese de agregar los archivos a un proyecto de complemento de Office. -* Tras convertir estos modelos de diseño en una aplicación de una página (SPA), todas las secciones de la página HTML se alinean a la parte superior y se superponen entre sí. - * Solución: Al convertir desde HTML, se pueden agregar otros DIV de contenedor. Asegúrese de que la altura de estos DIV adicionales se restablezca correctamente. Por ejemplo, si un DIV primario se establece en una altura de 100 %, un DIV secundario no tiene altura y un DIV descendiente del secundario se establece en 100 %, debe establecer el DIV secundario al 100 % para mostrar las secciones correctamente. - -## Recursos adicionales +1. Descargue o bifurque el proyecto de ejemplo. +1. Cree un nuevo directorio en el directorio raíz web llamado `php-calendar`. Copie los archivos del repositorio en este directorio. +1. [Registre la aplicación en Azure Active Directory](https://github.com/jasonjoh/office365-azure-guides/blob/master/RegisterAnAppInAzure.md). Se debe registrar la aplicación como una aplicación web con una dirección URL de inicio de sesión de `http://localhost/php-calendar` y se le debe dar el permiso "Tener acceso total a los calendarios de los usuarios", que está disponible en la lista desplegable "Permisos delegados". +1. Edite el archivo `.\o365\ClientReg.php`. + 1. Copie el Id. de cliente de aplicación obtenido durante el registro de la aplicación y péguelo como valor de la variable `$clientId`. + 1. Copie la clave que creó durante el registro de la aplicación y péguela como valor de la variable `$clientSecret`. + 1. Guarde el archivo. +1. Si la instalación de PHP no está configurada con los certificados de entidad emisora actualizados para comprobar SSL, se producirá un error en las solicitudes a no ser que ejecute Fiddler en el servidor y establezca la variable `$enableFiddler` como `true` en `Office365Service.php`. Como alternativa, puede insertar la línea siguiente justo antes de cualquier llamada a `curl_exec`. **Sin embargo,** debe tenerse en cuenta que al hacerlo se deshabilita cualquier comprobación de SSL, por lo que NO se debe realizar en un entorno de producción. -* [Procedimientos recomendados para desarrollar complementos de Office](https://dev.office.com/docs/add-ins/overview/add-in-development-best-practices) -* [Office UI Fabric](http://dev.office.com/fabric/) Este proyecto usa la versión 2.1.0 o una posterior. + curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, 0); +1. Abra un explorador web y vaya a `http://localhost/php-calendar/home.php`. +1. Verá una lista de las próximas sesiones de las diversas obras de Shakespeare. Haga clic en cualquiera de los botones "Conectar mi calendario" para iniciar sesión en Office 365. +1. Una vez iniciada la sesión, se le debe redirigir a la página principal y los botones ahora deben indicar "Agregar al calendario". Haga clic en el botón situado junto a una sesión específica para agregarla al calendario. Los eventos con un campo "Vale requerido" con valor Sí incluirá el vale como datos adjuntos del evento. -Este proyecto ha adoptado el [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) (Código de conducta de código abierto de Microsoft). Para obtener más información, consulte las [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) (Preguntas más frecuentes del código de conducta) o póngase en contacto con [opencode@microsoft.com](mailto:opencode@microsoft.com) con otras preguntas o comentarios. +## Copyright ## -Copyright (c) Microsoft Corporation 2016. Todos los derechos reservados. +Copyright (c) Microsoft. Todos los derechos reservados. +---------- +Conectar conmigo en Twitter [@JasonJohMSFT](https://twitter.com/JasonJohMSFT) +Seguir el [Blog de desarrollo de Exchange](http://blogs.msdn.com/b/exchangedev/) \ No newline at end of file diff --git a/README-Localized/README-fr-fr.md b/README-Localized/README-fr-fr.md index c76622f..6ad2e6f 100644 --- a/README-Localized/README-fr-fr.md +++ b/README-Localized/README-fr-fr.md @@ -1,42 +1,46 @@ -# Modèles de conception de l’expérience utilisateur pour les compléments Office +# Exemple d’API de calendrier PHP # -Ce référentiel fournit des exemples d’implémentation de modèles de conception d’expérience utilisateur courants dans du code HTML, CSS et JavaScript pour les compléments Office. +[日本 (日本語)](https://github.com/jasonjoh/php-calendar/blob/master/loc/readme-ja.md) (japonais) -Quand vous créez des compléments Office, vous devez concevoir une expérience utilisateur intéressante qui étend les possibilités d’Office. Votre complément doit, entre autres, offrir une première expérience intéressante aux utilisateurs et assurer des transitions fluides entre les pages. En offrant aux utilisateurs une expérience nette et moderne, vous les persuaderez de continuer à utiliser votre complément. Ce référentiel dispose de ressources liées à l’expérience utilisateur pouvant être utilisées par les développeurs qui implémentent : +Cet exemple montre comment vous pouvez utiliser l’[API Calendrier](https://msdn.microsoft.com/office/office365/APi/calendar-rest-operations) à partir de PHP. L’exemple d’application présente les prochaines représentations d’un festival de théâtre shakespearien. Les utilisateurs peuvent connecter leur compte Office 365 et ajouter des événements à leur calendrier pour afficher les horaires des représentations auxquelles ils souhaitent assister. L’utilisateur peut inviter des amis en envoyant une invitation aux amis de son choix. -* des modèles de conception d’expérience utilisateur courants en faisant appel aux meilleures pratiques ; -* des styles et des composants de la structure Office ; -* des compléments ressemblant à une extension naturelle de l’interface utilisateur d’Office par défaut. +## Fonctionnalités de l’API utilisées ## -Pour obtenir des informations générales et connaître les types de modèles de conception d’expérience utilisateur disponibles, reportez-vous à l’article relatif aux [modèles de conception d’expérience utilisateur pour les compléments Office](https://dev.office.com/docs/add-ins/design/ux-design-patterns). +- Création d’événements dans le calendrier par défaut d’un utilisateur +- Ajout de pièces jointes aux événements +- Ajout de participants aux événements +- Utilisation d’un [affichage Calendrier](https://msdn.microsoft.com/office/office365/APi/calendar-rest-operations#GetCalendarView) pour développer les événements périodiques et afficher tous les rendez-vous d’une seule journée. -> Important : Après avoir personnalisé ces modèles de conception pour les adapter à vos besoins, veillez à tester votre complément sur toutes les plateformes où il sera disponible. Ces modèles de conception d’expérience utilisateur ont été testés à l’aide d’Office 2016 et de Windows 10. +## Logiciels requis ## -## Utilisation des modèles de conception d’expérience utilisateur +- [PHP 5.6](http://php.net/downloads.php) +- Un serveur web capable d’utiliser PHP. -Vous pouvez vous servir des [spécifications du concepteur d’expérience utilisateur](https://github.com/OfficeDev/Office-Add-in-UX-Design-Patterns) comme guide lorsque vous créez votre propre conception d’expérience utilisateur. Vous pouvez également choisir d’ajouter le [code source](https://github.com/OfficeDev/Office-Add-in-UX-Design-Patterns-Code/tree/master/templates) directement à votre projet. Pour ajouter le code source, procédez comme suit : +Dans mon test, j’ai utilisé IIS 8 sur un ordinateur portable Windows 8.1. J’ai installé PHP 5.6.0 à l’aide de [Web Platform Installer](http://www.microsoft.com/web/downloads/platform.aspx) (Windows/IIS uniquement). -1. Clonez ce référentiel. -2. Copiez le [dossier des composants](https://github.com/OfficeDev/Office-Add-in-UX-Design-Pattern-Code/tree/master/assets) ainsi que le dossier de code pour le modèle individuel que vous choisissez dans votre projet de complément. -3. Incorporez le modèle individuel à votre complément. Par exemple : - - Modifiez l’emplacement source ou l’URL de commande de complément dans le manifeste. - - Utilisez le modèle de conception d’expérience utilisateur en tant que modèle pour d’autres pages. - - Lien vers ou à partir du modèle de conception d’expérience utilisateur. +## Exécution de l’exemple ## -## Problèmes connus +Avant de commencer, PHP doit être installé et votre serveur web doit être configuré pour traiter et utiliser les fichiers PHP. -* L’exécution de certains fichiers de code en dehors d’un projet de complément génère une erreur JavaScript. - * Résolution : veillez à ajouter ces fichiers à un projet de complément Office. -* Après avoir converti ces modèles de conception en une SPA (application à page unique), toutes les sections de la page HTML s’alignent en haut et se superposent. - * Résolution : Lors de la conversion à partir d’un format HTML, des éléments DIV de wrapper supplémentaires peuvent être ajoutés. Assurez-vous que la hauteur de ces éléments DIV supplémentaires est réinitialisée correctement. Par exemple, si un DIV parent est défini sur une hauteur de 100 %, qu’un DIV enfant n’a aucune hauteur et qu’un DIV petit-enfant est défini sur 100 %, vous devez définir le DIV enfant sur 100 % pour que les sections s’affichent correctement. - -## Ressources supplémentaires +1. Téléchargez ou dupliquez l’exemple de projet. +1. Créez un répertoire dans votre répertoire racine web appelé `php-calendar`. Copiez les fichiers du référentiel dans ce répertoire. +1. [Inscrivez l’application dans Azure Active Directory](https://github.com/jasonjoh/office365-azure-guides/blob/master/RegisterAnAppInAzure.md). L’application doit être inscrite comme une application web avec une URL de connexion `http://localhost/php-calendar`. Elle doit recevoir l’autorisation « Accès total aux calendriers des utilisateurs », disponible dans la liste déroulante « Autorisations déléguées ». +1. Modifiez le fichier `.\o365\ClientReg.php`. + 1. Copiez l’ID client de votre application obtenue durant l’inscription de l’application et collez-le à l’emplacement de la valeur correspondant à la variable `$clientId`. + 1. Copiez la clé créée durant l’inscription de l’application et collez-la à l’emplacement de la valeur correspondant à la variable `$clientSecret`. + 1. Enregistrez le fichier. +1. Si votre installation PHP n’est pas configurée avec des certificats d’autorité de certification mis à jour pour vérifier SSL, les requêtes échoueront, sauf si vous exécutez Fiddler sur le serveur et définissez la variable `$enableFiddler` sur `true` dans `Office365Service.php`. Vous pouvez également insérer la ligne suivante immédiatement avant un appel à `curl_exec`. **Toutefois,** en faisant cela vous désactivez toute vérification SSL, ce qui doit être évité en mode production. -* [Meilleures pratiques en matière de développement de compléments Office](https://dev.office.com/docs/add-ins/overview/add-in-development-best-practices) -* [Office UI Fabric](http://dev.office.com/fabric/). Ce projet utilise la version 2.1.0 au minimum. + curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, 0) ; +1. Ouvrez un navigateur web et accédez à `http://localhost/php-calendar/home.php`. +1. Une liste des représentations à venir devrait s’afficher. Cliquez sur l’un des boutons « Connecter mon calendrier » pour vous connecter à Office 365. +1. Une fois connecté, vous serez redirigé vers la page d’accueil et les boutons devraient indiquer « Ajouter au calendrier ». Cliquez sur le bouton à côté d’une représentation pour l’ajouter à votre calendrier. Les événements dont le champ « Reçu requis » indique « Oui » inséreront le reçu en pièce jointe dans l’événement. -Ce projet a adopté le [code de conduite Microsoft Open Source](https://opensource.microsoft.com/codeofconduct/). Pour plus d’informations, reportez-vous à la [FAQ relative au code de conduite](https://opensource.microsoft.com/codeofconduct/faq/) ou contactez [opencode@microsoft.com](mailto:opencode@microsoft.com) pour toute question ou tout commentaire. +## Copyright ## -Copyright (c) Microsoft Corporation 2016. Tous droits réservés. +Copyright (c) Microsoft. Tous droits réservés. +---------- +Suivez-moi sur Twitter [@JasonJohMSFT](https://twitter.com/JasonJohMSFT) +Suivez le [blog de développement Exchange](http://blogs.msdn.com/b/exchangedev/) \ No newline at end of file diff --git a/README-Localized/README-ja-jp.md b/README-Localized/README-ja-jp.md index 4b7c9c4..e4cd1af 100644 --- a/README-Localized/README-ja-jp.md +++ b/README-Localized/README-ja-jp.md @@ -1,42 +1,46 @@ -# Office アドインの UX 設計パターン +# PHP 予定表 API のサンプル # -このリポジトリは、Office アドイン用の共通 UX 設計パターンの HTML、CSS、JavaScript のサンプル実装を提供します。 +[日本 (日本語)](https://github.com/jasonjoh/php-calendar/blob/master/loc/readme-ja.md) (日本語) -Office アドインを設計する場合、作成するアドインの UX 設計は、Office を拡張する魅力的なエクスペリエンスを提供する必要があります。たとえば、アドインは初回実行時エクスペリエンス、ファーストクラスの UX エクスペリエンス、ページ間のスムーズな移動などを提供する必要があります。クリーンでモダンな UX エクスペリエンスを提供すると、ユーザーによるアドインの保持や採用が増加します。このリポジトリは、以下を実装する開発者のための UX リソースを提供します。 +このサンプルは、PHP の[予定表 API](https://msdn.microsoft.com/office/office365/APi/calendar-rest-operations) を使用する方法を示しています。サンプル アプリは、架空のコミュニティ劇場のシェークスピア祭の「今後の公演」アプリです。ユーザーは、Office 365 アカウントに接続し、参加する公演について予定表にイベントを追加することができます。ユーザーには、友人を招待して、招待した友人それぞれに会議出席依頼を送信するオプションがあります。 -* ベスト プラクティスに基づく共通 UX 設計パターン。 -* Office のファブリック コンポーネントとスタイル。 -* 既定の Office UI の自然な拡張機能に見えるアドイン。 +## 使用する API の機能 ## -使用可能な UX 設計パターン概要と種類については、「[Office アドイン用の UX 設計パターン テンプレート](https://dev.office.com/docs/add-ins/design/ux-design-patterns)」を参照してください。 +- ユーザーの既定の予定表にイベントを作成する +- イベントに添付ファイルを追加する +- イベントに出席者を追加する +- [予定表ビュー](https://msdn.microsoft.com/office/office365/APi/calendar-rest-operations#GetCalendarView)を使用して、定期的なイベントを展開し、1 日のすべての予定を表示します。 -> 重要事項:要件を満たすようにこれらの設計パターンをカスタマイズした後、アドインが使用可能となるすべてのプラットフォームでアドインのテストを実行してください。これらの UX 設計パターンは、Office 2016 と Windows 10 を使用してテストされました。 +## 必要なソフトウェア ## -## UX 設計パターンの使用 +- [PHP 5.6](http://php.net/downloads.php) +- PHP に対応可能な Web サーバーです。 -[UX デザイナー仕様](https://github.com/OfficeDev/Office-Add-in-UX-Design-Patterns)を独自の UX 設計を作成する際のガイドとして使用することも、[ソース コード](https://github.com/OfficeDev/Office-Add-in-UX-Design-Patterns-Code/tree/master/templates)をプロジェクトに直接追加することもできます。ソース コードを追加するには、次のようにします。 +私のテストでは、Windows 8.1 ノート PC にインストールされている IIS 8 を使用しました。[Web Platform インストーラー](http://www.microsoft.com/web/downloads/platform.aspx) (Windows/IIS のみ) を使用して、PHP 5.6.0 をインストールしました。 -1. このリポジトリの複製を作成します。 -2. [資産フォルダー](https://github.com/OfficeDev/Office-Add-in-UX-Design-Pattern-Code/tree/master/assets)と、アドイン プロジェクトに対して選択した個々のパターンのコード フォルダーをコピーします。 -3. 個々のパターンをアドインに組み込みます。たとえば次のようにします。 - - マニフェスト内で、ソースの場所またはアドイン コマンドの URL を編集します。 - - 他のページのテンプレートとして、UX 設計パターンを使用します。 - - UX 設計パターンとの間にリンクを設定します。 +## サンプルの実行 ## -## 既知の問題 +開始する前に PHP がインストールされていること、および Web サーバーが処理用に構成され、サーバーの PHP ファイルが構成されていることが前提となっています。 -* アドイン プロジェクトの外部でコード ファイルを実行すると、JavaScript エラーがスローされます。 - * 解決方法:これらのファイルが Office アドイン プロジェクトに追加されていることを確認します。 -* これらの設計パターンを単一ページ アプリ (SPA) に変換すると、HTML ページのすべてのセクションが上詰めになり、互いに重なってしまいます。 - * 解決方法:HTML から変換する場合、追加のラッパー DIV を追加できます。これら追加した DIV の高さが正しくリセットされることを確認します。たとえば、親 DIV を高さ 100%、子 DIV を高さなし、孫 DIV を 100% に設定した場合、子 DIV を 100% に設定し、セクションのレイアウトを適切に設定する必要があります。 - -## その他の技術情報 +1. サンプル プロジェクトをダウンロードまたは分岐します。 +1. `php-calendar` という Web のルート ディレクトリに新しいディレクトリを作成します。このディレクトリに、リポジトリからファイルをコピーします。 +1. [Azure Active Directory にアプリを登録](https://github.com/jasonjoh/office365-azure-guides/blob/master/RegisterAnAppInAzure.md)します。アプリは、サインオン URL が `http://localhost/php-calendar` の Web アプリとして登録されている必要があります。また、[ユーザーの予定表へのフル アクセス] のアクセス許可が付与されている必要があります。このアクセス許可は、[代理アクセス許可] ドロップダウン リストから使用できます。 +1. `.\o365\ClientReg.php` ファイルを編集します。 + 1. アプリの登録時に取得したアプリのクライアント ID をコピーし、`$clientId` 変数の値として貼り付けます。 + 1. アプリの登録時に作成したキーをコピーし、`$clientSecret` 変数の値として貼り付けます。 + 1. ファイルを保存します。 +1. PHP のインストールが SSL を検証するための更新された CA 証明書以外で構成されている場合、サーバーで Fiddler を実行し、かつ `$enableFiddler` で変数 `true` を `Office365Service.php` に設定するというのでない限り、要求は失敗します。代わりに、`curl_exec` への呼び出しの直前に次の行を挿入することができます。**ただし、** そのようにすると、SSL 検証がすべて無効になるため、運用環境では実行しないほうがよいことに注意してください。 -* [Office アドイン開発のベスト プラクティス](https://dev.office.com/docs/add-ins/overview/add-in-development-best-practices) -* [Office UI Fabric](http://dev.office.com/fabric/)このプロジェクトは、バージョン 2.1.0 以降を使用します。 + curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, 0); +1. Web ブラウザーを開き、`http://localhost/php-calendar/home.php` を参照します。 +1. 今後のさまざまなシェークスピア演劇の上演時間が一覧表示されていることが分かります。いずれかの [予定表に接続] ボタンをクリックすると、Office 365 にサインインします。 +1. サインインすると、ホーム ページにリダイレクトされ、ボタンは [予定表に追加] に変わります。特定の上演時間の横にあるボタンをクリックすると、その時間が予定表に追加されます。[はい] の [伝票が必要] フィールドがあるイベントには、イベントの添付ファイルとして伝票が含まれています。 -このプロジェクトでは、[Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) が採用されています。詳細については、「[規範に関する FAQ](https://opensource.microsoft.com/codeofconduct/faq/)」を参照してください。または、その他の質問やコメントがあれば、[opencode@microsoft.com](mailto:opencode@microsoft.com) までにお問い合わせください。 +## 著作権 ## -Copyright (c) Microsoft Corporation 2016.All rights reserved. +Copyright (c) Microsoft. All rights reserved. +---------- +Twitter ([@JasonJohMSFT](https://twitter.com/JasonJohMSFT)) をぜひフォローしてください。 +[Exchange 開発ブログ](http://blogs.msdn.com/b/exchangedev/)をフォローする \ No newline at end of file diff --git a/README-Localized/README-pt-br.md b/README-Localized/README-pt-br.md index 9be4344..db0b30a 100644 --- a/README-Localized/README-pt-br.md +++ b/README-Localized/README-pt-br.md @@ -1,42 +1,46 @@ -# Padrões de design da experiência do usuário para suplementos do Office +# Exemplo de API de Calendário PHP # -Este repositório fornece implementações de exemplo em HTML, CSS e JavaScript de padrões de design comuns da experiência do usuário para suplementos do Office. +[日本 (日本語)](https://github.com/jasonjoh/php-calendar/blob/master/loc/readme-ja.md) (japonês) -Ao criar suplementos do Office, o design da experiência do usuário do suplemento deve fornecer experiências atraentes que estendam as funcionalidades do Office. Por exemplo, o suplemento deve fornecer uma tela de apresentação, uma experiência do usuário de primeira classe e transições suaves entre as páginas, entre outros itens. Fornecer uma experiência do usuário simples e moderna aumenta a retenção de usuários e a adoção do suplemento. Esse repositório dispõe de recursos da experiência do usuário para desenvolvedores que implementam: +Este exemplo mostra como usar a [API de Calendário](https://msdn.microsoft.com/office/office365/APi/calendar-rest-operations) no PHP. O exemplo é um aplicativo de "espetáculos futuros" destinado a um festival shakespeariano de uma comunidade fictícia de teatro. Os usuários podem conectar as respectivas contas do Office 365 e adicionar eventos ao calendário com os horários dos espetáculos em que vão participar. O usuário tem a opção de convidar amigos, que envia uma solicitação de reunião a cada amigo convidado. -* Padrões de design comuns da experiência do usuário com base nas práticas recomendadas. -* Estilos e componentes do Office Fabric. -* Suplementos que parecem uma extensão natural da interface do usuário padrão do Office. +## Recursos usados da API ## -Para obter informações gerais e os tipos de padrões de design de experiência do usuário disponíveis, confira o artigo [Modelos de padrão de design de experiência do usuário para suplementos do Office](https://dev.office.com/docs/add-ins/design/ux-design-patterns). +- Como criar eventos em um calendário padrão do usuário +- Como adicionar anexos aos eventos +- Como adicionar participantes aos eventos +- Usando o [modo de exibição Calendário](https://msdn.microsoft.com/office/office365/APi/calendar-rest-operations#GetCalendarView) para expandir os eventos recorrentes e exibir todos os compromissos de um único dia. -> Importante: Após personalizar esses padrões de design para atender às suas necessidades, lembre-se de testar seu suplemento em todas as plataformas onde seu suplemento estará disponível. Esses padrões de design da experiência do usuário foram testados usando o Office 2016 e Windows 10. +## Software necessário ## -## Usar os padrões de design da experiência do usuário +- [PHP 5.6](http://php.net/downloads.php) +- Um servidor Web compatível com PHP. -Você pode usar as [especificações de design da experiência do usuário](https://github.com/OfficeDev/Office-Add-in-UX-Design-Patterns) como um guia para criar um design personalizado da experiência do usuário ou pode adicionar o [código-fonte](https://github.com/OfficeDev/Office-Add-in-UX-Design-Patterns-Code/tree/master/templates) diretamente no projeto. Para adicionar o código-fonte: +Em meus testes, usei o IIS 8 instalado em um laptop com Windows 8.1. Instalei o PHP 5.6.0 usando o [Web Platform Installer](http://www.microsoft.com/web/downloads/platform.aspx) (somente para Windows/IIS). -1. Clone este repositório. -2. Copie a [pasta de ativos](https://github.com/OfficeDev/Office-Add-in-UX-Design-Pattern-Code/tree/master/assets) e a pasta de código do padrão específico que você escolheu para o projeto do seu suplemento. -3. Incorpore o padrão individual ao seu suplemento. Por exemplo: - - Edite o local de origem ou a URL de comando do suplemento no manifesto. - - Use o padrão de design da experiência do usuário como modelo para outras páginas. - - Crie um link para o padrão de design da experiência do usuário. +## Execução do exemplo ## -## Problemas conhecidos +Presumimos que você já instalou o PHP antes de começar, e que configurou o servidor Web para processar e servir arquivos do PHP. -* A execução de alguns arquivos de código fora de um projeto de suplemento gera um erro de JavaScript. - * Resolução: Adicione esses arquivos a um projeto de suplemento do Office. -* Após a conversão desses padrões de design para um Aplicativo de Página Única (SPA), todas as seções da página HTML ficam alinhadas na parte superior e se sobrepõem umas às outras. - * Resolução: Ao converter de HTML, DIVs de invólucro adicionais podem ser adicionados. Certifique-se de que a altura desses DIVs adicionais sejam redefinidas corretamente. Por exemplo, se um DIV pai estiver definido com uma altura de 100%, um DIV filho não tiver altura e um DIV neto for definido como 100%, será necessário definir o DIV filho como 100% para realizar o layout das seções corretamente. - -## Recursos adicionais +1. Baixe ou bifurque o projeto de exemplo. +1. Crie um novo diretório, no diretório raiz da Web, chamado `php-calendar`. Copie os arquivos do repositório para este diretório. +1. [Registre o aplicativo no Azure Active Directory](https://github.com/jasonjoh/office365-azure-guides/blob/master/RegisterAnAppInAzure.md). É necessário registrar o aplicativo como um aplicativo Web usando a URL de Entrada do `http://localhost/php-calendar` e atribuir a ele a permissão "Ter acesso total aos calendários dos usuários", que está disponível na lista suspensa "Permissões delegadas". +1. Edite o arquivo `.\o365\ClientReg.php`. + 1. Copie a ID do cliente obtida durante o registro do aplicativo e cole-a como o valor da variável `$clientId`. + 1. Copie a chave criada durante o registro do aplicativo e cole-a como o valor da variável `$clientSecret`. + 1. Salve o arquivo. +1. Se não configurou a instalação do PHP com um Certificado de Autoridade de Certificação atualizado para verificar o SSL, as solicitações falharão, a menos que você execute o Fiddler no servidor e defina a variável `$enableFiddler` como `true`, no `Office365Service.php`. Como alternativa, insira a seguinte linha, imediatamente antes das chamadas para `curl_exec`. **No entanto**, ao fazê-lo, desabilitará as verificações de SSL, o que NÃO deve ser feito durante a produção. -* [Práticas recomendadas para desenvolvimento de suplementos do Office](https://dev.office.com/docs/add-ins/overview/add-in-development-best-practices) -* [Office UI Fabric](http://dev.office.com/fabric/). Este projeto usa a versão 2.1.0 ou superior. + curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, 0); +1. Abra um navegador da Web e navegue até `http://localhost/php-calendar/home.php`. +1. Você verá uma lista de horários de espetáculos futuros para várias peças do festival shakespeariano. Clique em um dos botões "Conectar meu Calendário" para entrar no Office 365. +1. Depois de entrar, você será redirecionado para a home page, e os botões estarão exibidos com o texto "Adicionar ao Calendário". Clique no botão ao lado de um horário de espetáculo específico para adicioná-lo ao calendário. Os eventos com um campo "Cupom obrigatório" definido como Sim incluirão o cupom como anexo no evento. -Este projeto adotou o [Código de Conduta do Código Aberto da Microsoft](https://opensource.microsoft.com/codeofconduct/). Para saber mais, confira as [Perguntas frequentes do Código de Conduta](https://opensource.microsoft.com/codeofconduct/faq/) ou contate [opencode@microsoft.com](mailto:opencode@microsoft.com) se tiver outras dúvidas ou comentários. +## Direitos autorais ## -Copyright (c) Microsoft Corporation 2016. Todos os direitos reservados. +Copyright (c) Microsoft. Todos os direitos reservados. +---------- +Conecte-se comigo no Twitter [@JasonJohMSFT](https://twitter.com/JasonJohMSFT) +Siga o [Blog de desenvolvedores do Exchange](http://blogs.msdn.com/b/exchangedev/) \ No newline at end of file diff --git a/README-Localized/README-ru-ru.md b/README-Localized/README-ru-ru.md index f8a175e..530416d 100644 --- a/README-Localized/README-ru-ru.md +++ b/README-Localized/README-ru-ru.md @@ -1,42 +1,46 @@ -# Шаблоны UX-дизайна для надстроек Office +# Пример использования API календаря в PHP # -В этом репозитории представлены примеры реализации распространенных шаблонов UX-дизайна для надстроек Office на HTML, CSS и JavaScript. +[日本 (日本語)](https://github.com/jasonjoh/php-calendar/blob/master/loc/readme-ja.md) (японский) -UX-дизайн надстроек Office должен повышать привлекательность Office. Обеспечьте инструкции при первом запуске, первоклассные функциональные возможности и плавные переходы между страницами. Надстройки с понятным и современным интерфейсом более популярны среди пользователей. В этом репозитории представлены UX-ресурсы для разработчиков, которые реализуют: +Использование [API календаря](https://msdn.microsoft.com/office/office365/APi/calendar-rest-operations) из PHP показано на примере приложения с ближайшими показами шекспировского фестиваля вымышленного театра. Пользователь может подключить свою учетную запись Office 365 и добавлять в свой календарь показы, которые планирует посетить. Пользователь может приглашать друзей. При этом им будут отправляться приглашения на собрание. -* Стандартные шаблоны UX-дизайна, созданные на основе накопленного опыта. -* Компоненты и стили Office Fabric. -* Надстройки, прекрасно вписывающиеся в стандартный пользовательский интерфейс Office. +## Используемые функции API ## -Общие сведения и типы доступных шаблонов UX-дизайна см. в статье [Шаблоны UX-дизайна для надстроек Office](https://dev.office.com/docs/add-ins/design/ux-design-patterns). +- Создание событий в календаре пользователя по умолчанию +- Добавление вложений +- Добавление участников +- Использование [представления календаря](https://msdn.microsoft.com/office/office365/APi/calendar-rest-operations#GetCalendarView) для развертывания повторяющихся событий и отображения всех встреч для одного дня. -> Важно! Настроив эти шаблоны в соответствии со своими требованиями, проверьте надстройку на всех платформах, где она будет доступна. Эти шаблоны пользовательского интерфейса были протестированы в Office 2016 и Windows 10. +## Необходимое программное обеспечение ## -## Использование конструктивных шаблонов пользовательского интерфейса +- [PHP 5.6](http://php.net/downloads.php) +- Веб-сервер, способный обслуживать PHP. -Вы можете взять за основу [спецификации UX-конструктора](https://github.com/OfficeDev/Office-Add-in-UX-Design-Patterns) при создании UX-дизайна или добавить [исходный код](https://github.com/OfficeDev/Office-Add-in-UX-Design-Patterns-Code/tree/master/templates) прямо в свой проект. Чтобы добавить исходный код: +В ходе тестирования я использовал IIS 8, установленный на ноутбуке с Windows 8.1. Я установил PHP 5.6.0, используя [ установщик веб-платформы](http://www.microsoft.com/web/downloads/platform.aspx) (только для Windows/IIS). -1. Клонируйте этот репозиторий. -2. Скопируйте [папку с ресурсами](https://github.com/OfficeDev/Office-Add-in-UX-Design-Pattern-Code/tree/master/assets) и папку с кодом выбранного шаблона в проект надстройки. -3. Внедрите шаблон в надстройку. Например: - - Измените расположение исходного кода или URL-адрес команд надстройки в манифесте. - - Используйте шаблон UX-дизайна в качестве шаблона для других страниц. - - Создайте ссылки на шаблон UX-дизайна. +## Запуск приложения ## -## Известные проблемы +Предполагается, что перед запуском вы установили PHP, и ваш веб-сервер настроен на обработку и обслуживание PHP-файлов. -* При выполнении некоторых файлов с кодом за пределами проекта надстройки возникает ошибка JavaScript. - * Решение: добавьте эти файлы в проект Office. -* После преобразования этих шаблонов в одностраничное приложение (SPA) все разделы HTML-страницы будут выровнены по верхнему краю и наложены друг на друга. - * Решение. При преобразовании из формата HTML могут быть добавлены дополнительные оболочки DIV. Убедитесь, что высота этих дополнительных оболочек сбрасывается надлежащим образом. Например, если для родительского элемента DIV задана высота 100 %, для дочернего элемента DIV высота не задана, а для внучатого элемента DIV задана высота 100 %, то для дочернего элемента необходимо задать высоту 100 %, чтобы правильно расположить разделы. - -## Дополнительные ресурсы +1. Скачайте проект приложения или создайте вилку. +1. Создайте каталог в корневом каталоге документов с именем `php-calendar`. Скопируйте файлы из репозитория в этот каталог. +1. [Зарегистрируйте приложение в Azure Active Directory](https://github.com/jasonjoh/office365-azure-guides/blob/master/RegisterAnAppInAzure.md). Зарегистрируйте приложение как веб-приложение с URL-адресом входа `http://localhost/php-calendar` и предоставьте ему разрешение "Полный доступ к календарям пользователей", которое доступно в раскрывающемся списке "Делегированные разрешения". +1. Измените файл `.\o365\ClientReg.php`. + 1. Скопируйте идентификатор клиента, полученный при регистрации приложения, и вставьте его в качестве значения переменной `$clientId`. + 1. Скопируйте ключ, созданный при регистрации приложения, и вставьте его в качестве значения переменной `$clientSecret`. + 1. Сохраните файл. +1. Если установка PHP не использует обновленные сертификаты ЦС для проверки SSL, запросы не будут выполняться, если вы не запустите Fiddler на сервере и не присвоите переменной `$enableFiddler` значение `true` в `Office365Service.php`. Кроме того, вы можете вставить следующую строку перед всеми вызовами `curl_exec`. **Однако** помните, что при этом отключается проверка SSL, что НЕДОПУСТИМО в промышленном коде. -* [Рекомендации по разработке надстроек Office](https://dev.office.com/docs/add-ins/overview/add-in-development-best-practices) -* [Office UI Fabric](http://dev.office.com/fabric/). В этом проекте используется версия 2.1.0 или более поздняя. + curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, 0); +1. Откройте браузер и перейдите по адресу `http://localhost/php-calendar/home.php`. +1. Вы увидите список предстоящих показов различных пьес Шекспира. Нажмите любую кнопку "Подключить мой календарь", чтобы войти в Office 365. +1. После входа вы будете перенаправлены на домашнюю страницу, и теперь кнопки будут иметь надпись "Добавить в календарь". Нажмите кнопку рядом с показом, чтобы добавить его в свой календарь. К событиям со значением "Да" в поле "Ваучер обязателен" будет прикреплен ваучер. -Этот проект соответствует [правилам поведения Майкрософт, касающимся обращения с открытым кодом](https://opensource.microsoft.com/codeofconduct/). Читайте дополнительные сведения в [разделе вопросов и ответов по правилам поведения](https://opensource.microsoft.com/codeofconduct/faq/) или отправляйте новые вопросы и замечания по адресу [opencode@microsoft.com](mailto:opencode@microsoft.com). +## Авторское право ## -© Корпорация Майкрософт (Microsoft Corporation), 2016. Все права защищены. +(c) Корпорация Майкрософт (Microsoft Corporation). Все права защищены. +---------- +Свяжитесь со мной в Twitter [@JasonJohMSFT](https://twitter.com/JasonJohMSFT) +Подпишитесь на [блог для разработчиков Exchange](http://blogs.msdn.com/b/exchangedev/) \ No newline at end of file diff --git a/README-Localized/README-zh-cn.md b/README-Localized/README-zh-cn.md index fed1714..13ce41c 100644 --- a/README-Localized/README-zh-cn.md +++ b/README-Localized/README-zh-cn.md @@ -1,42 +1,46 @@ -# 适用于 Office 外接程序的 UX 设计模式 +# PHP 日历 API 示例 # -此存储库为 Office 外接程序提供了常见 UX 设计模式的 HTML、CSS 和 JavaScript 中的示例实现。 +[日本 (日本語)](https://github.com/jasonjoh/php-calendar/blob/master/loc/readme-ja.md) (Japanese) -在设计 Office 外接程序时，外接程序的 UX 设计应该提供引人注目的扩展 Office 体验。例如，外接程序应该提供首次运行体验、一流的 UX 体验以及页面之间与其他功能之间的流畅切换。提供干净、现代的 UX 体验增加用户留存率和外接程序的采用率。本存储库为开发人员提供了 UX 资源，以实现： +本示例演示如何从 PHP 使用[日历 API](https://msdn.microsoft.com/office/office365/APi/calendar-rest-operations)。 该示例应用是一个虚构的社区剧院莎士比亚节的“预告节目”应用。 用户可以连接自己的 Office 365 帐户，并将事件添加到自己的日历中，以了解他们要参与的节目时间。 用户可以选择邀请朋友，这将向每个受邀朋友发送会议请求。 -* 基于最佳实践的常见 UX 设计模式。 -* Office 结构组件和样式。 -* 类似于默认 Office UI 自然延伸的外接程序。 +## 使用的 API 功能 ## -有关概述以及可用的用户体验设计模式类型，请参阅[适用于 Office 加载项的用户体验设计模式模板](https://dev.office.com/docs/add-ins/design/ux-design-patterns)。 +- 在用户的默认日历上创建事件 +- 将附件添加到事件 +- 将参加者添加到事件 +- 使用[日历视图](https://msdn.microsoft.com/office/office365/APi/calendar-rest-operations#GetCalendarView)展开定期事件并显示一天的所有约会。 -> 重要说明：自定义这些设计模式以满足你的需求后，请确保在你的外接程序可用的所有平台上测试你的外接程序。使用 Office 2016 和 Windows 10 对这些 UX 设计模式进行了测试。 +## 所需软件 ## -## 使用用户体验设计模式 +- [PHP 5.6](http://php.net/downloads.php) +- 能够提供 PHP 服务的 Web 服务器。 -在创建你自己的 UX 设计时，可以使用 [UX 设计器规范](https://github.com/OfficeDev/Office-Add-in-UX-Design-Patterns)作为指南，或者直接将[源代码](https://github.com/OfficeDev/Office-Add-in-UX-Design-Patterns-Code/tree/master/templates)添加到你的项目。添加源代码： +在我的测试中，我使用了安装在 Windows 8.1 笔记本电脑上的 IIS 8。 我使用 [Web 平台安装程序](http://www.microsoft.com/web/downloads/platform.aspx)安装了 PHP 5.6.0（仅限Windows/IIS）。 -1. 克隆此存储库。 -2. 将 [assets 文件夹](https://github.com/OfficeDev/Office-Add-in-UX-Design-Pattern-Code/tree/master/assets)和选定各个模式的代码文件夹复制到加载项项目。 -3. 将个人模式纳入到外接程序中。例如： - - 编辑清单中的源位置或外接程序命令 URL。 - - 将 UX 设计模式用作其他页面的模板。 - - 链接至 UX 设计模式。 +## 运行示例 ## -## 已知问题 +假设你在启动之前安装了 PHP，并且 Web 服务器已配置为进程和服务器 PHP 文件。 -* 运行外接程序项目外的某些代码文件会引发 JavaScript 错误。 - * 解决方案：确保将这些文件添加到 Office 外接程序项目。 -* 在这些设计模式转换为单页应用 (SPA) 后，HTML 页的所有部分变为顶部对齐并相互重叠。 - * 解决方案：从 HTML 进行转换时，可能添加额外包装 DIV。确保正确重置这些额外 DIV 的高度。例如，若父级 DIV 设置为 100% 高度，子级 DIV 无高度，而孙级 DIV 设置为 100%，则你需要将子级 DIV 设置为 100% 以正确对部分进行布局。 - -## 其他资源 +1. 下载示例项目或为其创建分支。 +1. 在名为 `php-calendar` 的 Web 根目录中创建新目录。 将文件从存储库复制到此目录。 +1. [在 Azure Active Directory 中注册应用](https://github.com/jasonjoh/office365-azure-guides/blob/master/RegisterAnAppInAzure.md)。 该应用应注册为登录 URL 为 `http://localhost/php-calendar` 的 Web 应用，并应获得“能够完全访问用户日历”的权限，该权限可在“委派权限”下拉列表中找到。 +1. 编辑 `.\o365\ClientReg.php` 文件。 + 1. 复制在应用注册期间获取的应用的客户端 ID，并将其粘贴为 `$clientId` 变量的值。 + 1. 复制在应用注册期间创建的密钥，并将其粘贴为 `$clientSecret` 变量的值。 + 1. 保存文件。 +1. 如果 PHP 安装未配置更新的 CA 证书以验证 SSL，请求将会失败，除非你在服务器上运行 Fiddler 并在 `Office365Service.php` 中将 `$enableFiddler` 变量设置为 `true`。 或者，可以在对 `curl_exec` 进行任何调用之前直接插入以下行。 **但是，** 应注意，这样做会禁用任何 SSL 验证，这不应在生产中完成。 -* [Office 加载项开发最佳做法](https://dev.office.com/docs/add-ins/overview/add-in-development-best-practices) -* [Office UI Fabric](http://dev.office.com/fabric/)。此项目使用版本 2.1.0 或更高版本。 + curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, 0); +1. 打开 Web 浏览器，浏览到 `http://localhost/php-calendar/home.php`。 +1. 应能看到各种莎士比亚戏剧预告节目的时间列表。 单击任何“连接我的日历”按钮，登录到 Office 365。 +1. 登录后，应该会将你重定向回主页，并且按钮现在应显示为“添加到日历”。 单击特定节目时间旁的按钮，将其添加到日历。 如果某个事件的“需要凭证”字段为“是”，它将包含凭证作为事件的附件。 -此项目采用 [Microsoft 开源行为准则](https://opensource.microsoft.com/codeofconduct/)。有关详细信息，请参阅 [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)（行为准则常见问题解答），有任何其他问题或意见，也可联系 [opencode@microsoft.com](mailto:opencode@microsoft.com)。 +## 版权 ## -版权所有 (c) Microsoft Corporation 2016。保留所有权利。 +版权所有 (c) Microsoft。保留所有权利。 +---------- +在 Twitter 上通过 [@JasonJohMSFT](https://twitter.com/JasonJohMSFT) 与我联系 +关注 [Exchange 开发人员博客](http://blogs.msdn.com/b/exchangedev/) \ No newline at end of file diff --git a/README-Localized/README-zh-tw.md b/README-Localized/README-zh-tw.md index f42cc65..0242e95 100644 --- a/README-Localized/README-zh-tw.md +++ b/README-Localized/README-zh-tw.md @@ -1,42 +1,46 @@ -# Office 增益集的 UX 設計模式 +# PHP 行事曆 API 範例 # -此儲存機制提供 Office 增益集的一般 UX 設計模式的 HTML、CSS 和 JavaScript 中的範例實作。 +[日本 (日本語)](https://github.com/jasonjoh/php-calendar/blob/master/loc/readme-ja.md) (Japanese) -設計 Office 增益集時，增益集的 UX 設計應提供可擴充 Office 的絕佳體驗。例如，您的增益集應該提供初次執行體驗、最出色 UX 經驗，以及能夠流暢地在其他頁面間轉換。提供簡潔、最新的 UX 體驗能夠提升使用者忠誠度並讓更多人採用您的增益集。這個儲存機制具有開發人員的 UX 資源，會實作： +本範例顯示如何使用 PHP 的[行事曆 API](https://msdn.microsoft.com/office/office365/APi/calendar-rest-operations)。 該範例應用程式是一個虛構社區劇院莎士比亞節的「即將演出」應用程式。 使用者可以連線至其 Office 365 帳戶，並將事件新增到他們的行事曆以記下要參加的演出時間。 使用者可以選擇邀請朋友，這將會傳送會議邀請給每位受邀朋友。 -* 根據最佳作法的一般 UX 設計模式。 -* Office Fabric 元件與樣式。 -* 看起來像預設 Office UI 自然擴充的增益集。 +## 使用的 API 功能 ## -如需可用的 UX 設計模式概觀資訊及類型，請參閱 [Office 增益集的 UX 設計模式範本](https://dev.office.com/docs/add-ins/design/ux-design-patterns)。 +- 在使用者的預設行事曆上建立事件 +- 新增附件至事件 +- 新增出席者至事件 +- 使用[行事曆檢視](https://msdn.microsoft.com/office/office365/APi/calendar-rest-operations#GetCalendarView)展開週期性事件，並顯示一天內的所有約會。 -> 重要事項：自訂這些設計模式以符合您的需求之後，一定要在您的增益集可用的所有平台上測試增益集。使用 Office 2016 和 Windows 10 測試這些 UX 設計模式。 +## 必要的軟體 ## -## 使用 UX 設計模式 +- [PHP 5.6](http://php.net/downloads.php) +- 支援 PHP 的網頁伺服器。 -當您要建立自己的 UX 設計時，可以使用 [UX 設計工具的規格](https://github.com/OfficeDev/Office-Add-in-UX-Design-Patterns)做為指引，或可以直接將[原始程式碼](https://github.com/OfficeDev/Office-Add-in-UX-Design-Patterns-Code/tree/master/templates)新增至您的專案。若要新增原始原始碼︰ +在測試中，我使用了安裝在 Windows 8.1 筆記本電腦上的 IIS 8。 我使用 [Web 平台安裝程式](http://www.microsoft.com/web/downloads/platform.aspx)安裝了 PHP 5.6.0 (僅限 Windows/IIS)。 -1. 複製此儲存機制。 -2. 將[資產資料夾](https://github.com/OfficeDev/Office-Add-in-UX-Design-Pattern-Code/tree/master/assets)及您所選的個別模式的程式碼資料夾，複製到您的增益集專案。 -3. 將個別模式納入您的增益集。例如： - - 編輯資訊清單中的來源位置或增益集命令 URL。 - - 使用 UX 設計模式作為其他網頁的範本。 - - 從 UX 設計模式連結或連結至 UX 設計模式。 +## 執行範例 ## -## 已知問題 +假設您在啟動之前已安裝了 PHP，並且網路伺服器已設定為處理和服務 PHP 檔案。 -* 執行增益集專案以外的某些程式碼檔案會擲回 JavaScript 錯誤。 - * 解決方案：請確定您在 Office 增益集專案中加入這些檔案。 -* 將這些設計模式轉換為單一頁面應用程式 (SPA) 之後，HTML 網頁的所有區段會變成靠上對齊，並與彼此重疊。 - * 解決方案：從 HTML 轉換時，可能會新增其他包裝函式 DIV。請確定適當重設這些額外的 DIV 的高度。例如，如果父系 DIV 設為 100% 的高度，子系 DIV 沒有高度，孫系 DIV 設為 100%，則您需要將子系 DIV 設為 100%，以適當地配置區段。 - -## 其他資源 +1. 下載或分岔範例專案。 +1. 在網路根目錄中建立名為 `php-calendar` 的新目錄。 將檔案從存放庫複製到這個目錄中。 +1. [在 Azure Active Directory 中註冊應用程式](https://github.com/jasonjoh/office365-azure-guides/blob/master/RegisterAnAppInAzure.md). 該應用程式應註冊為具有 `http://localhost/php-calendar` 登入 URL 的網路應用程式，並應獲得「具有使用者行事曆完整存取權」權限，該權限可在「委派的權限」下拉式清單中找到。 +1. 編輯 `.\o365\ClientReg.php` 檔案。 + 1. 複製在應用程式註冊期間取得的應用程式用戶端識別碼，並將其貼為 `$clientId` 變數的值。 + 1. 複製在應用程式註冊期間建立的機碼，並將其貼為 `$clientSecret` 變數的值。 + 1. 儲存檔案。 +1. 如果您的 PHP 安裝未設定更新的 CA 憑證以驗證 SSL，除非您在伺服器上執行 Fiddler 並將 `Office365Service.php`中的 `$enableFiddler` 變數設定為 `true`，否則要求會失敗。 或者，您可以在呼叫 `curl_exec` 之前插入下行。 **不過，** 請注意，這麼做會停用任何 SSL 驗證，因此您不應在生產環境中執行此操作。 -* [開發 Office 增益集的最佳做法](https://dev.office.com/docs/add-ins/overview/add-in-development-best-practices) -* [Office UI 結構](http://dev.office.com/fabric/)。此專案會使用版本 2.1.0 或更新版本。 + curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, 0); +1. 開啟網頁瀏覽器並瀏覽至 `http://localhost/php-calendar/home.php`。 +1. 您應該會看到一份各個莎士比亞戲劇即將演出的時間表。 按下任一個 [連線我的行事曆] 按鈕以登入 Office 365。 +1. 登入後，您將會重新導向至首頁，而按鈕現在會顯示為 [新增到行事曆]。 按一下指定演出時間旁的按鈕，以將它新增至您的行事曆。 「必要的憑證」欄位為「是」的事件將包含作為事件附件的憑證。 -此專案已採用 [Microsoft 開放原始碼執行](https://opensource.microsoft.com/codeofconduct/)。如需詳細資訊，請參閱[程式碼執行常見問題集](https://opensource.microsoft.com/codeofconduct/faq/)，如果有其他問題或意見，請連絡 [opencode@microsoft.com](mailto:opencode@microsoft.com)。 +## 著作權 ## -Copyright (c) Microsoft Corporation 2016.著作權所有，並保留一切權利。 +Copyright (c) Microsoft.著作權所有，並保留一切權利。 +---------- +跟隨我的推特 ([@JasonJohMSFT](https://twitter.com/JasonJohMSFT)) +請追蹤 [Exchange 開發人員部落格](http://blogs.msdn.com/b/exchangedev/) \ No newline at end of file