Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Importante
Los complementos de SharePoint alcanzaron la finalización de su vida útil en SharePoint Online el 2 de abril de 2026. Tanto los complementos hospedados por SharePoint como los hospedados por el proveedor se retiran y ya no funcionan en SharePoint Online, incluidas las nubes de administración pública. Las instrucciones de uso, implementación y desarrollo de complementos se conservan como referencia histórica y para escenarios de SharePoint Server aplicables, no para nuevas soluciones de SharePoint Online.
Los complementos de SharePoint Server implementados a través de un catálogo de aplicaciones local no se retiran por este cambio. La adquisición de complementos de SharePoint en el marketplace público finalizó el 2 de abril de 2026 para SharePoint Server.
Esta retirada no retira las API de REST DE SHAREPOINT, CSOM, JSOM o SharePoint Framework (SPFx). Para SharePoint Online, use SPFx para las extensiones de la interfaz de usuario y Microsoft Entra ID para la autenticación en aplicaciones externas. Consulte el anuncio de retirada y las instrucciones de migración de complementos.
Importante
Esta guía se aplica a las experiencias clásicas de SharePoint y al modelo de complemento de SharePoint. Las páginas maestras personalizadas no se admiten en las experiencias modernas de SharePoint Online y se consideran un enfoque de personalización heredado.
El enfoque que adopte para implementar páginas maestras personalizadas en sitios de SharePoint es diferente en el nuevo modelo de complementos de SharePoint que con el código de plena confianza/soluciones de granja de servidores. En un escenario típico de código de confianza total (FTC)/solución de granja de servidores, las páginas maestras personalizadas se crean para implementar una marca personalizada. Las páginas maestras normalmente se empaquetan en una función que usa código declarativo y una solución FTC/granja para implementar las páginas maestras y registrarlas en el sitio de SharePoint.
En un escenario de personalización de marca del modelo de complemento de SharePoint, se pueden usar páginas maestras personalizadas. Puede implementar y registrar sus páginas maestras personalizadas en sitios de SharePoint a través del patrón de aprovisionamiento remoto.
Directrices de alto nivel para páginas patrón personalizadas
Como regla general, nos gustaría proporcionar las siguientes directrices de alto nivel para las páginas maestras personalizadas.
- Puede personalizar sitios de SharePoint mediante páginas maestras personalizadas, pero tenga en cuenta que esto supondrá costes adicionales a largo plazo y dificultades con las actualizaciones futuras.
En la mayoría de los casos, puede lograr todos los escenarios de marca comunes con temas, apariencias compuestas y CSS alternativo.
Vea Sitios de SharePoint de personalización de marca (receta del complemento de SharePoint) para obtener información sobre las diferentes opciones de personalización de marca que tiene para los sitios de SharePoint con el modelo de complemento de SharePoint. La receta lo ayudará a considerar el impacto a corto y largo plazo de la personalización desde una perspectiva operativa y de mantenimiento. Es posible que descubra que no es necesaria una página maestra personalizada para implementar sus requisitos de marca específicos.
Si decide usar páginas maestras personalizadas, prepárese para aplicar cambios a las páginas maestras personalizadas cuando se apliquen actualizaciones funcionales importantes a Microsoft 365.
- Use el aprovisionamiento remoto para implementar y registrar páginas maestras personalizadas con sitios de SharePoint.
- No use código declarativo ni código de espacio aislado para implementar ni registrar páginas maestras con sitios de SharePoint.
Sitios de grupo frente a sitios de publicación
¿Cuándo se necesita una página maestra personalizada?
Al aplicar la personalización de marca a los sitios de SharePoint, encontrará la necesidad de marcar tanto los sitios de grupo como los sitios de publicación. En general, las intranets basadas en SharePoint tanto en escenarios locales como de Microsoft 365 usan una combinación de sitios de grupo y sitios de publicación.
Los requisitos de marca personalizados a menudo requieren cambios de diseño específicos que los temas y las técnicas de incrustación de JavaScript no pueden lograr.
En este escenario, los sitios de grupo normalmente no requieren la cantidad de personalización de marca que requieren los sitios de publicación y la vista contemporánea de SharePoint lista para usar para dispositivos móviles es suficiente para admitir dispositivos móviles para sitios de grupo. Dado que este es el caso, es mejor usar páginas maestras personalizadas solo para publicar sitios y usar temas AlternativeCSS y personalizados de SharePoint (archivos *.spcolor ), combinaciones de fuentes (archivos *.spfont ) e imágenes de fondo definidas como apariencias compuestas para los sitios de grupo de la marca.
Consideraciones de implementación
- Al implementar páginas maestras personalizadas en sitios de publicación, solo tiene que implementar las páginas maestras personalizadas en el sitio raíz.
- En Provisioning.PublishingFeatures (ejemplo de PnP) se muestra cómo implementar páginas maestras personalizadas en sitios de publicación.
- Al implementar páginas maestras personalizadas en sitios que no son de publicación, debe implementar las páginas maestras personalizadas en cada sitio.
Las páginas maestras personalizadas se suelen aplicar cuando se aprovisiona un sitio. El proceso de aprovisionamiento remoto encaja bien con este enfoque. Normalmente, la única vez que usará el explorador web para aplicar manualmente la personalización de la marca de SharePoint es cuando está creando prototipos o modificando un único sitio de SharePoint que no está previsto que crezca para incluir otras colecciones de sitios o subsitios.
- Consulte los módulos (receta del complemento de SharePoint) y el aprovisionamiento del sitio (receta del complemento de SharePoint) para obtener más detalles sobre la implementación y ejemplos adicionales.
Más detalles sobre las páginas maestras personalizadas y los diseños de página para los sitios de SharePoint
En escenarios en los que una página maestra personalizada sea la única manera de implementar sus requisitos personalizados de personalización de marca, puede crear una página maestra y diseños de página personalizados. Tenga en cuenta los puntos que se hicieron al principio de este artículo con respecto a los costos de mantenimiento a largo plazo asociados con este enfoque.
- Utilizar páginas maestras personalizadas para sitios de SharePoint proporciona el último nivel de personalización (ilimitado).
- Utilizar páginas maestras personalizadas para sitios de SharePoint requiere la mayor cantidad de tiempo para implementar y mantener a corto y largo plazo.
- Los cambios realizados en las páginas maestras integradas que vienen con las actualizaciones de servicio no se reflejarán en las páginas maestras personalizadas.
- Puede aplicar las páginas maestras personalizadas en el nivel de cada sitio.
- Al usar una página maestra personalizada, se recomienda empezar con una de las páginas maestras listas para usar y modificarla para satisfacer sus necesidades.
- Intente minimizar la cantidad de personalización que realiza con las páginas maestras personalizadas; esto facilitará su actualización cuando los cambios en el servicio de Microsoft 365 a páginas maestras listas para usar se deban replicar en páginas maestras personalizadas.
- Hay muchos marcadores de posición de contenido necesarios en las páginas maestras de SharePoint que no deben quitarse o provocarán un error en las páginas. Sabrá cuándo ha quitado un marcador de posición de contenido necesario porque en el momento en que lo implemente y asigne la página maestra al sitio, aparecerán errores.
¿Cuándo son una buena solución las páginas maestras personalizadas y los diseños de página para un sitio de SharePoint?
Esta opción funciona bien cuando tus necesidades de personalización de marca son específicas o estás usando sitios de publicación.
Enfoques de implementación recomendados
- Las páginas maestras personalizadas se pueden cargar manualmente mediante el explorador web y asignarse a apariencias compuestas.
- Asimismo, las páginas maestras personalizadas se pueden cargar y asignar a un sitio de SharePoint mediante el patrón de aprovisionamiento remoto.
- Consulte los módulos (receta del complemento de SharePoint) y el aprovisionamiento del sitio (receta del complemento de SharePoint) para obtener más detalles sobre la implementación y ejemplos adicionales.
Vínculos relacionados
- Módulos (receta del complemento de SharePoint)
- Aprovisionamiento de sitios (receta del complemento de SharePoint)
- Personalización de marca Sitios de SharePoint (receta del complemento de SharePoint)
- Artículos de orientación sobre el desarrollo de Office 365 y SharePoint PnP Guía para el desarrollo
Ejemplos de PnP
- Administración de temas con CSOM (ejemplo de Microsoft 365 PnP)
- Propiedades AlternateCSSUrl y SiteLogoUrl en el objeto web (ejemplo PnP)
- Establecer el tema en el sitio (ejemplo de PnP)
- Establecer un tema de SharePoint en una aplicación para SharePoint (ejemplo de PnP)
- Hacer que Seattle master responsive listo para usar (ejemplo de PnP)
- Ejemplos y contenido en https://github.com/pnp/PnP
Se aplica a
- Microsoft 365 multiinquilino (MT)
- Microsoft 365 Dedicado (D) parcialmente
- SharePoint 2013 local parcial
Los modelos para Office 365 dedicado y local son idénticos a las técnicas del modelo de complemento de SharePoint, pero existen algunas diferencias en las posibles tecnologías que se pueden usar.