Partager via


Comment : importer une page maître ou un thème

Vous pouvez accorder aux pages de votre site SharePoint une apparence cohérente lors de la création et l'utilisation 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 Blocs de construction : Pages et l'interface utilisateur sur le site Web 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, sélectionnez 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 sélectionnez le nœud 2010 .

  4. Dans la liste de modèles SharePoint, sélectionnez le modèle Module , puis spécifiez un nom pour le package.

    Un module contient des fichiers (par exemple, page maître ou fichiers de thème) 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. Sélectionnez le nœud de module.

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

    Les fichiers de page maître portent l'extension .master, et les fichiers de thème portent l'extension de .thmx.

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

    [!REMARQUE]

    Des erreurs peuvent se produire si le nom de la page maître est le même que celui 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 le fichier Elements.xml.

    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.

  10. 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.

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

    Une valeur Web signifie que la page maître s'applique uniquement au site Web actuellement spécifié dans le projet.Une 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.

    [!REMARQUE]

    Étant donné que les thèmes s'appliquent uniquement au niveau de la collection de sites, nous vous recommandons de ne définissez pas la portée d'un thème à une valeur autre que 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 dans le menu Actions du site , choisissez la commande Paramètres du site , puis cliquez sur le lien Pages maîtres ou le lien Thèmes .

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

Voir aussi

Concepts

Importation d'éléments d'un site SharePoint existant

Utilisation de modules pour inclure des fichiers dans la solution

Autres ressources

Pages maîtres

Création de pages pour SharePoint