Comment : importer une page maître ou un thème
Les pages maîtres et les thèmes permettent de donner une apparence cohérente aux pages d'un site SharePoint. Bien que Visual Studio ne fournisse pas de modèles pour les pages maîtres ou les thèmes, vous pouvez en créer dans SharePoint Designer, puis les importer dans Visual Studio. Ce document explique comment importer des pages maîtres et des thèmes. Pour plus d'informations, consultez Bloc de construction : pages et interface utilisateur sur le site Web MSDN.
Pour importer une page maître ou un thème
Ouvrez un projet SharePoint dans Visual Studio.
Si vous n'avez pas de projet, vous pouvez créer un projet SharePoint vide. Pour plus d'informations, consultez Modèles de projets et d'éléments de projet SharePoint.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nœud de projet, pointez sur Ajouter, puis cliquez sur Nouvel élément.
Dans la boîte de dialogue Ajouter un nouvel élément, dans la liste de modèles SharePoint, sélectionnez Module. Donnez un nom au module.
Un module est utilisé comme conteneur pour déployer des fichiers, par exemple des fichiers de page maître ou de thème, vers un emplacement spécifié dans SharePoint.
Dans le module, supprimez le fichier Sample.txt par défaut.
Pour ajouter le fichier de page maître ou de thème au module, sélectionnez le nœud de module, puis, dans le menu Projet, cliquez sur Ajouter un élément existant. Recherchez le fichier de page maître ou de thème, et sélectionnez-le. Les fichiers de page maître portent l'extension de nom de fichier .master et les fichiers de thème portent l'extension de nom de fichier .thmx.
Si vous avez ajouté une page maître, modifiez son paramètre Résolution de conflit de déploiement en Automatique.
Notes
Si le nom de la page maître est le même que le nom d'une page maître existante marquée comme page maître par défaut ou page maître personnalisée, des erreurs peuvent se produire. Pour plus d'informations sur la résolution de ce problème, consultez Procédure pas à pas : importation d'une page maître et d'une page de site personnalisées avec une image.
Dans le module, double-cliquez sur le fichier Elements.xml pour l'ouvrir dans l'éditeur.
Vous devez mettre à jour le fichier Elements.xml pour référencer la page maître ou le thème que vous venez d'ajouter.
Pour une page maître, remplacez la balise de module existante par la balise suivante.
<Module Name="[Module Name]" Url="_catalogs/masterpage"> <File Path="[Module Name]\[Master Page Name].master" Url="[Master Page Name].master" Type="GhostableInLibrary" /> </Module>Pour un thème, remplacez la balise de module existante par la balise suivante.
<Module Name="[Module Name]" Url="_catalogs/theme" <File Path="[Module Name]\[Theme Name].thmx" Url="[Theme Name].thmx" Type="GhostableInLibrary" /> </Module>Veillez à remplacer les valeurs d'espace réservé par les noms réels du module et de la page maître ou du thème.
L'attribut Type="GhostableInLibrary" indique que l'élément est ajouté à la base de données de contenu, et l'attribut Url du module spécifie l'emplacement de stockage du fichier dans la base de données de contenu SharePoint.
Pour modifier la portée de déploiement de la page maître, dans l'Explorateur de solutions, double-cliquez sur le fichier de fonctionnalité pour l'afficher dans le Concepteur de fonctionnalités.
Cliquez sur la zone Portée pour spécifier la portée de la page maître.
La valeur Web signifie que la page maître s'applique uniquement au site Web actuellement spécifié dans le projet. La valeur Site signifie que la page maître s'applique à la collection de sites actuelle, qui inclut tous les sous-sites et le Web racine. Les autres valeurs ne s'appliquent pas.
Notes
Étant donné que les thèmes s'appliquent uniquement au niveau de la collection de sites, nous vous recommandons de ne pas affecter une autre valeur que Site à la portée d'un thème. Des erreurs peuvent se produire si un thème est utilisé dans un sous-site.
Dans le menu Générer, cliquez sur Déployer la solution.
Pour vérifier que les fichiers ont été déployés correctement, ouvrez le site SharePoint.
Dans SharePoint, sous l'onglet Actions du site, cliquez sur Paramètres du site.
Si vous avez ajouté une page maître, dans la page Paramètres du site, cliquez sur Pages maîtres pour afficher la liste des pages maîtres. Si vous avez ajouté un thème, dans la page Paramètres du site, cliquez sur Thèmes pour afficher la liste des thèmes. La page maître ou le thème importé(e) devrait se trouver dans la liste.
Voir aussi
Concepts
Importation d'éléments d'un site SharePoint existant
Utilisation de modules pour inclure des fichiers dans la solution