update of the readme files

README-Localized/README-de-de.md

@@ -1,42 +1,46 @@
-# <a name="ux-design-patterns-for-office-add-ins"></a>UX-Entwurfsmuster für Office-Add-Ins 
+# <a name="php-calendar-api-sample"></a>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 
+## <a name="api-features-used"></a>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.
+## <a name="required-software"></a>Erforderliche Software ##
 
-## <a name="using-the-ux-design-patterns"></a>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.
+## <a name="running-the-sample"></a>Ausführen des Beispiels ##
 
-## <a name="known-issues"></a>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.    
-
-## <a name="additional-resources"></a>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 [[email protected]](mailto:[email protected]).
+## <a name="copyright"></a>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/)

README-Localized/README-es-es.md

@@ -1,42 +1,46 @@
-# <a name="ux-design-patterns-for-office-add-ins"></a>Modelos de diseño de la experiencia de usuario para complementos de Office 
+# <a name="php-calendar-api-sample"></a>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. 
+## <a name="api-features-used"></a>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.
+## <a name="required-software"></a>Software necesario ##
 
-## <a name="using-the-ux-design-patterns"></a>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.
+## <a name="running-the-sample"></a>Ejecución del ejemplo ##
 
-## <a name="known-issues"></a>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.    
-
-## <a name="additional-resources"></a>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 [[email protected]](mailto:[email protected]) con otras preguntas o comentarios.
+## <a name="copyright"></a>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/)