Comment puis-je utiliser le 3WDOC Studio sur mon propre nom de domaine ?

Un des véritables atouts du 3WDOC Studio est que l’utilisateur qui a son propre nom de domaine et sa plate-forme d’hébergement, peut installer une version complète de 3WDOC Studio à sa propre adresse.

A titre d’exemple, disons que vous voulez installer le 3WDOC Studio sur votre blog ou sur votre site, c’est ce que nous allons voir dès à présent dans cet article.

Vous devez avoir des notions de base de ce qu’est un fichier de configuration et l’accès FTP à votre espace d’hébergement sans pour autant être un expert.

Afin d’être le plus pédagogique possible, nous allons essayer d’installer le Studio 3WDOC sur le blog de Hecube, notre autre Blog.

  • Le blog est disponible au http://social.hecube.net/
  • Le chemin du répertoire sur le serveur qui contient le blog est /blog.hecube.net
  • Vous devez avoir créer un compte @ http://account.3wdoc.com/account/signin/

Comment enregistrer votre nom de domaine ?

Voici un rapide aperçu des 5 étapes pour enregistrer son domaine @http://account.3wdoc.com

Etape 1. Allez sur votre compte et enregistrez le domaine

Lorsque vous êtes logué(e) sur votre compte utilisateur sur 3WDOC, vous pouvez voir à droite de la barre grise, un lien nommé Enregistrer un domaine. Cliquez dessus et puis vous arrivez à l’écran où vous pouvez enregistrer votre domaine.

1.1 Le lien Enregistrer un domaine
3WDOC Studio - Comment puis-je utiliser le 3WDOC Studio sur mon propre nom de domaine ?

1.1 L’écran où vous pouvez Enregistrer un domaine
3WDOC Studio - Comment puis-je utiliser le 3WDOC Studio sur mon propre nom de domaine ?

Etape 2. Saisissez votre nom de domaine

Entrez l’adresse complète de votre site, dans notre exemple, c’est l’adresse de notre blog http://social.hecube.net/. Nous avons donc entré social.hecube.net dans le champs texte sans le “slash” de fin. Il ne reste plus alors qu’à cliquer sur le bouton VALIDER
3WDOC Studio - Comment puis-je utiliser le 3WDOC Studio sur mon propre nom de domaine ?

Etape 3. Télécharger le fichier d’activation 3wdoc-registeractivate.txt

Comme pour l’inscription sur Google analytics, 3WDOC veut s’assurer que vous êtes bien le titulaire de ce nom de domaine que vous venez d’entrer dans notre système. C’est la raison pour laquelle vous êtes invité(e) à placer à la racine de votre serveur un fichier nommé 3wdoc-registeractivate.txt qui prouve que vous pouvez utiliser ce nom de domaine.

Voici un exemple de ce qui figure dans le fichier :

social.hecube.net|1e7e99b0f808765e6884ff2b064f0c9c6a6f24b5-4df332b3ca0561-06274411

3WDOC Studio - Comment puis-je utiliser le 3WDOC Studio sur mon propre nom de domaine ?

Vous pouvez télécharger le fichier d’activation 3wdoc-registeractivate.txt en cliquant sur le bouton ACTIVATION FILE

3WDOC Studio - Comment puis-je utiliser le 3WDOC Studio sur mon propre nom de domaine ?

Etape 4. Envoyez en FTP à la racine de votre serveur le fichier d’activation 3wdoc-registeractivate.txt

Vous devez envoyer le fichier 3wdoc-registeractivate.txt à l’aide de votre logiciel FTP favori par exemple Filezilla. Le fichier doit être accessible via votre navigateur à une adresse sur votre site web. Dans notre exemple, le fichier se trouve à http://social.hecube.net/3wdoc-registeractivate.txt

3WDOC Studio - Comment puis-je utiliser le 3WDOC Studio sur mon propre nom de domaine ?

Le fichier d’activation est disponible à http://social.hecube.net/3wdoc-registeractivate.txt
3WDOC Studio - Comment puis-je utiliser le 3WDOC Studio sur mon propre nom de domaine ?

Etape 5. Cliquez sur le bouton ACTIVER pour activer votre nom de domaine

Le fichier d’activation se trouve sur votre serveur, il vous faut alors revenir à votre compte d’utilisateur sur 3WDOC et cliquer sur le bouton ACTIVER avec une flèche bleue. L’activation est faite, vous pouvez désormais utiliser 3WDOC Studio sur votre serveur et installer le fichier zip qui contient tous les fichiers du 3WDOC Studio.

3WDOC Studio - Comment puis-je utiliser le 3WDOC Studio sur mon propre nom de domaine ?

Dans notre exemple, le domaine social.hecube.net a bien le statut ACTIVÉ

3WDOC Studio - Comment puis-je utiliser le 3WDOC Studio sur mon propre nom de domaine ?

Vous allez recevoir un mail de confirmation avec toutes les informations nécessaires. VOUS AVEZ FINI AVEC L’ACTIVATION DU NOM DE DOMAINE ! Nous allons vous montrer comment installer le fichier 3WDOC Studio dans ce domaine.

3WDOC Studio - Comment puis-je utiliser le 3WDOC Studio sur mon propre nom de domaine ?

Comment faire pour installer l’ensemble du 3WDOC Studio sur le nom de domaine que vous venez d’enregistrer ?

Une fois votre domaine enregistré et activé, vous pouvez télécharger le package qui contient le Studio 3WDOC. Si vous cliquez sur le bouton 3WDOC STUDIO, vous allez télécharger un fichier du nom 3wdoc-rawpackage.zip. Il contient tous les fichiers 3WDOC Studio, vous devez le décompresser et l’envoyer par FTP à votre serveur.

Dans notre exemple souvenez-vous que vous aurez besoin de :

  1. Nom de domaine enregistré : le Studio 3WDOC va être installé sur le nom de domaine que nous venons juste d’enregistrer. Le Studio 3WDOC sera disponible à cette adresse spécifique: http://social.hecube.net/my_studio
  2. L’emplacement du répertoire sur le serveur dans lequel nous allons placer le 3WDOC Studio : /blog.hecube.net/my_studio

Etape 1 – Téléchargez le 3wdoc-Studio (3wdoc-rawpackage.zip)

Toutes ces instructions sont dans le fichier readme qui est présent dans le dossier que vous venez de télécharger. 3wdoc-rawpackage.zip.

3WDOC Studio - Comment puis-je utiliser le 3WDOC Studio sur mon propre nom de domaine ?

Etape 2 – Modifiez la valeur _HE3WS_LOC_BASE_DOCROOT dans le fichier he3Configuration.php

Vous devez éditer avec votre éditeur favori, la ligne contenant _HE3WS_LOC_BASE_DOCROOT dans le fichier he3Configuration.php. Dans notre exemple, le _HE3WS_LOC_BASE_DOCROOT est my_studio parce que nous avons l’intention d’utiliser le studio 3WDOC à l’adresse suivante http://social.hecube.net/my_studio

		// define("_HE3WS_LOC_BASE_DOCROOT",				"");
		define("_HE3WS_LOC_BASE_DOCROOT",				"my_studio");

Etape 3 – Copier ou modifier votre fichier crossdomain.xml à la racine de votre serveur.

Vous devez autoriser l’accès à l’API 3WDOC avec l’aide du fichier crossdomain. Ce fichier doit être disponible à la racine de votre serveur.

Si vous n’avez pas de fichier crossdomain.xml en racine de votre serveur, vous pouvez le créer avec le code ci-dessus et la placer en FTP en racine de votre serveur.

	<?xml version="1.0"?>
	<!DOCTYPE cross-domain-policy 
	  SYSTEM "http://www.macromedia.com/xml/dtds/cross-domain-policy.dtd">
	<cross-domain-policy>
	        <allow-access-from domain="account.3wdoc.com" />
	</cross-domain-policy>

Ce fichier doit être disponible à la racine de votre serveur, c’est à dire que vous pouvez y accéder via une URL depuis votre navigateur. Ainsi dans notre exemple, le fichier est disponible à http://social.hecube.net/crossdomain.xml

Etape 4 – Allez sur la page he3Studio.php maintenant disponible sur votre serveur

Dans notre exemple, l’adresse de ce fichier he3Studio.php est http://social.hecube.net/my_studio/he3Studio.php. Il vous suffit alors de vous connecter avec votre identifiant et votre mot de passe …

Pour vous connecter au 3WDOC Studio, vous avez besoin du couple utilisateur/mot de passe que vous avez utiliser lors de la création de votre compte sur 3WDOC. Ça y est, vous avez votre propre studio 3WDOC disponible sur les serveurs 3WDOC.

La page de login du 3WDOC Studio he3Studio.php
3WDOC Studio - Comment puis-je utiliser le 3WDOC Studio sur mon propre nom de domaine ?

La page d’index vous donne accès à toutes les séquences publiées dans le Studio 3WDOC et disponibles par conséquent sur le Web.
3WDOC Studio - Comment puis-je utiliser le 3WDOC Studio sur mon propre nom de domaine ?

La page d’accueil du 3WDOC Studio
3WDOC Studio - Comment puis-je utiliser le 3WDOC Studio sur mon propre nom de domaine ?

L’éditeur 3WDOC Editeur et l’Editeur de Style disponibles dans le 3WDOC Studio
3WDOC Studio - Comment puis-je utiliser le 3WDOC Studio sur mon propre nom de domaine ?

Conclusion : Pour chaque domaine que vous enregistrez, vous pourrez avoir votre propre 3WDOC Studio. Il est possible d’installer autant de 3WDOC Studio par domaine enregistré.

The readme file

Toutes ces explications, en anglais, sont disponibles dans le fichier readme qui est contenu dans le fichier zip que vous pouvez télécharger avec le 3WDOC Studio.

		/**
		 * 
		 * 1/ Upload the 3wdoc-rawpackage to your website
		 * 
		 * Use your FTP client.
		 * 
		 * 
		 * 2/ The constant _HE3WS_LOC_BASE_DOCROOT must reflect your hosting parameters.
		 * 
		 * If the 3wdoc-rawpackage directory is a sub-directory of your docroot (eg. http://your.domain.tld/3wdoc-rawpackage), edit the file he3Configuration.php and change the line 
		 * define("_HE3WS_LOC_BASE_DOCROOT",				"");
		 * to
		 * define("_HE3WS_LOC_BASE_DOCROOT",				"3wdoc-rawpackage");
		 * 
		 * If the 3wdoc-rawpackage content is uploaded directly in the docroot you do not want to edit the file he3Configuration.php. The constant on the line
		 * define("_HE3WS_LOC_BASE_DOCROOT",				"");
		 * must be set with an empty string as shown above.
		 * 
		 * 
		 * 3/ copy the file crossdomain.xml in your docroot. If you already have a crossdomain.xml just paste the line
		 * <allow-access-from domain="account.3wdoc.com" />
		 * in the <cross-domain-policy/> node
		 * 
		 * 
		 * 4/ Head your browser to the he3Studio.php page, log-in using your email/password from your 3WDOC platform sign-in.
		 * 
		 * 
		 * 5/ Enjoy.
		 * 
		 * 
		 * For further explanations, please visit http://blog.3wdoc.com
		 */

3WDOC Studio

Quelques informations sur le Studio 3WDOC…

3WDOC Studio est un outil polyvalent spécialement conçu pour créer et délivrer en HTML5 vos contenus rich media optimisées sur le web. 3WDOC Studio a pour finalité première de mettre en mouvement des objets et des éléments Web (texte, photos, vidéos, arborescence, API, base de données…) dans la durée pour concevoir donc une narration web. 3WDOC Studio = 3WDOC Player + 3WDOC Editor.

Pour aller plus loin