Partager via


Importer une page maître ou un thème

Vous pouvez donner aux pages de votre site SharePoint une apparence homogène en créant et en utilisant des pages maîtres et des thèmes. Visual Studio ne fournit pas de modèles pour ces éléments, mais vous pouvez les créer dans SharePoint Designer, puis les importer dans Visual Studio. Pour plus d’informations, consultez Bloc de construction : pages et interface utilisateur sur le site web de Microsoft.

Pour importer une page maître ou un thème

  1. Dans Visual Studio, créez ou ouvrez un projet SharePoint.

    Pour plus d’informations sur la création d’un projet SharePoint, consultez Modèles de projets et d'éléments de projet SharePoint.

  2. Dans la barre de menus, choisissez Projet>Ajouter un nouvel élément.

  3. Dans la boîte de dialogue Ajouter un nouvel élément, développez le nœud SharePoint, puis choisissez le nœud 2010.

  4. Dans la liste des modèles SharePoint, choisissez le modèle Module, puis spécifiez le nom du module.

    Un module contient des fichiers (par exemple, des fichiers de pages maîtres ou de thèmes) pour le déploiement vers un emplacement que vous spécifiez dans SharePoint.

  5. Dans le module, supprimez le fichier par défaut, nommé Sample.txt.

  6. Choisissez le nœud du module.

  7. Dans la barre de menus, choisissez Projet>Ajouter un élément existant, puis choisissez le fichier de page maître ou de thème.

    Les fichiers de pages maîtres ont une extension .master et les fichiers de thèmes ont une extension .thmx.

  8. Si vous avez ajouté une page maître, définissez son paramètre Résolution de conflit de déploiement sur Automatique dans les propriétés du module.

    Notes

    Des erreurs peuvent se produire si le nom de la page maître est identique au nom d’une page maître existante marquée comme page maître par défaut ou page maître personnalisée. 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.

  9. Dans le module, ouvrez Elements.xml.

    Vous devez mettre à jour le fichier Elements.xml pour référencer la page maître ou le thème que vous avez ajouté.

  10. Pour une page maître, remplacez le balisage de module existant par le balisage suivant.

    <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 le balisage de module existant par le balisage suivant.

    <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 la page maître ou le thème.

    L’attribut Type="GhostableInLibrary" indique que l’élément est ajouté à la base de données de contenu et que l’attribut Url du module spécifie où stocker le fichier dans la base de données de contenu SharePoint.

  11. Pour modifier la portée de déploiement d’une page maître, dans l’Explorateur de solutions, ouvrez le fichier de fonctionnalités dans le Concepteur de fonctionnalités, puis choisissez une nouvelle portée de déploiement dans la liste Portée.

    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, y compris tous les sous-sites et le site 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 définir la portée d’un thème exclusivement sur site. Des erreurs peuvent se produire si un thème est utilisé dans un sous-site.

  12. (Dans la barre de menus, sélectionnez Générer>Déployer la solution.

  13. Pour vérifier si les fichiers ont été déployés correctement, ouvrez le site SharePoint, choisissez le menu Actions du site, choisissez la commande Paramètres du site, puis choisissez le lien Pages maîtres ou le lien Thèmes.

    La liste des pages maîtres ou des thèmes s’affiche et indique la page maître ou le thème que vous avez importé.