SharePoint 2013 : Design Manager – Construire une masterpage

Cet article est désormais disponible sur le Wiki TechNet. Accèder à l’article sur le Wiki Accèder au guide des articles en français du Wiki

J’ai effectué dans cet article un tour d’horizon du Design Manager.

Cet article couvre les points 3 et 4, à savoir les étapes nécessaires à la création d’une masterpage.

Il fait partie d’une série concernant le Design Manager de SharePoint 2013 :

• SharePoint 2013 : Design Manager – Présentation,
• SharePoint 2013 : Design Manager – Utiliser les Device Channels,
• SharePoint 2013 : Design Manager – Construire une masterpage (Cette page),
• SharePoint 2013 : Design Manager – Utiliser les Display Templates,
• SharePoint 2013 : Design Manager – Utiliser le Design Package.

Les étapes de création d’une masterpage via le Design Manager

Les étapes sont les suivantes :

• Vous créez dans votre éditeur HTML préféré une page web qui servira de base pour la création de votre masterpage,
• Vous téléchargez les éléments (page HTML, CSS, images) dans la galerie de masterpage,
• SharePoint 2013 convertit votre page en masterpage,
• Vous décidez des composants SharePoint (menus, webparts, …) à ajouter dans cette masterpage,
• Le DM génère le code HTML pour chaque composant que vous intégrez à votre page HTML déjà uploadée
• A chaque modification, SharePoint régénère la masterpage.

Etape 1 : Construire votre page HTML

Construisez une page HTML, comme bon vous semble, avec l’outil que vous voulez.

Que vous construisez cette page vous-même, que vous la récupériez d’une agence ou de la voisine n’a aucune importance, ce qu’il vous faut au final c’est un dossier avec :

• La page HTML,
• Les images,
• Les feuilles de style (*.css),
• etc.

Ici, j’ai choisi la facilité et récupéré un modèle « Prêt-à-l’emploi »:

Contenu du dossier :

Etape 2 : Télécharger les fichiers dans SharePoint

Une fois sur la page d’accueil du DM, cliquez sur « Upload Design Files » pour télécharger l’ensemble de votre dossier dans la bibliothèque de masterpage de votre collection de site.

Grâce à l’accès en webdav cette étape est une formalité :

Etape 3 : Visualiser votre masterpage

C’est ici qu’on passe aux choses sérieuses : SharePoint va convertir votre page HTML en masterpage.

Cliquez sur le lien « Convert … » :

Naviguez dans la galerie de masterpage jusqu’à sélectionner votre page HTML  et cliquez sur « Insert » :

La page est alors convertie (ici avec succès) :

Cliquez sur le lien pour obtenir un aperçu de cette masterpage :

Etape 4 : Insérer les contrôles SharePoint

Si vous observez le screenshot ci-dessus, la masterpage est « brute » : il va falloir maintenant insérer les contrôles SharePoint (menus, titre du site, webparts, …).

Le tout en gardant en tête que le div suivant (« ContentPlaceHolderMain » présent en bas de la masterpage) est le point central du design car embarquant le contenu de la page.

Pour cela cliquez sur « Snippets » en haut à droite :

Vous accédez alors à la page qui va vous permettre d’insérer les contrôles; en haut de la page, je clique sur « Top Navigation » afin d’insérer un menu dans la masterpage.

A noter qu’il y a foule de contrôles utilisables, difficile de ne pas trouver son bonheur.

S’affichent alors :

• Partie 1 : Un descriptif présentant le contrôle,
• Partie 2 : Une prévisualisation,
• Partie 3 : Le code généré à coller dans votre page HTML,
• Partie 4 : Les propriétés modifiables (bouton « Update »).

Une fois que vous estimez que votre contrôle est prêt, cliquez sur le bouton ci-dessous et collez le code dans votre page HTML (celle collée à l’étape 2).

Pour faire simple, utilisez un éditeur et modifiez directement la page HTML en webdav.

SharePoint synchronise alors vos modifications en convertissant automatiquement la page HTML en masterpage.

D’ailleurs dans la page HTML initiale, SharePoint ajoute le commentaire suivant :

 »

This HTML file has been associated with a SharePoint Master Page (.master file) carrying the same name. While the files remain associated, you will not be allowed to edit the .master file, and any rename, move, or deletion operations will be reciprocated.

To build the master page directly from this HTML file, simply edit the page as you normally would. Use the Snippet Generator at [….] to create and customize useful SharePoint entities, then copy and paste them as HTML snippets into your HTML code. All updates to this file will automatically sync to the associated Master Page.

 »

Et ainsi de suite avec tous vos contrôles, en conservant le div jaune en point central :

Une fois votre page HTML (et donc votre masterpage) achevée, publiez une version principale de la masterpage, paramétrez la sur votre site.

La page « Site settings » devient ici (avec juste un contrôle « Top Navigation » et « Site Title ») :

Conclusion

Personnellement, j’aime bien cette gestion « centralisée » des fonctionnalités de branding.

Dans la vraie vie on peut imaginer communiquer aux agences/designers les portions de code que l’on souhaite voir apparaître dans la masterpage, et récupérer le package (page  HTML + éléments) que l’on convertit ensuite via SharePoint.