Después de más de un mes sin postear, al fin me di tiempo para escribir sobre algo bastante útil a la hora de personalizar un sitio en SharePoint 2007, estoy hablando de las “masterpages“.

Casi puedo apostarles que, si están leyendo este blog, han al menos intentado cambiar el “look & feel” de SharePoint mediante el uso de las masterpages. Bien, la modificación de la masterpage debe basarse en la estructura que TODAS las páginas del sitio van a tener, es decir, por cada sitio, SharePoint te permite asignar un solo archivo *.master personalizado y por defecto es: default.master.

A pesar de que al principio, la personalización del archvio master principal puede resultar tediosa (recomiendo la “base master page” de Heather Solomon), ésta es la forma más sencilla de lograr un diseño totalmente diferente a lo que es SharePoint out-of-the-box.

Ahora, si lo que quieres es cambiar las páginas de aplicación de tu sitio, como las que viven dentro del directorio _layouts, _catalogs, etc., el procedimiento no es tan simple. Éstos directorios, contienen páginas comunes a todos los sitios y sitecollections de una ”web application“, esto es porque apuntan virtualmente a los archivos que son el “core” de SharePoint (comunmente están localizados en: Program Files/Common files/Microsoft Shared/web server extensions/12/). Entonces, cambiar directamente la masterpage (llamada application.master) de éstas páginas, afectaría a todos los sitios que tenga en mi servidor. Uhm, esto nos pone en un dilema, pues lo que Microsoft ha proporcionado como opciones “oficiales”, son un poco difíciles de replicar.

Básicamente la primera opción que nos propone es crear un respaldo del directorio _layouts, y directamente… cambiar el archivo application.master!!! Como dije anteriormente, esto nos lleva a usar el mismo diseño de masterpage en todos los sitios del web server. La segunda opción es replicar el directorio _layouts (re-nombrarlo), modificar el archivo application.master en la carpeta copiada, y cambiar el path del IIS, para que el directorio virtual de nuestro web site apunte a la recién creada carpeta… U_U sin comentarios…

Y pues la opción que no está “soportada” por Microsoft, pero que según mi experiencia y la de muchos “SharePoint devs” es la más apropiada para esta situación, es el uso de HttpModules.

Los HTTP Modules se definen en una sección del archivo web.config de cada sitio de SharePoint, y permiten interceptar peticiones de páginas, permitiendo ejecutar código justo antes de que la página se cargue. De hecho esta solución es usada también en aplicaciones comunes de ASP .NET y funciona bastante bien
Los pasos para utilizar HttpModules y cambiar así el archivo application.master de nuestro sitio son:

1. Crear un proyecto de tipo “Class Library” y llamarlo HttpModule.
2. Cambiar la clase generada (Class1) por CustomApplicationMaster y agregar el siguiente código:

using System;
using System.Web;
using System.Web.UI;
using System.IO;

namespace HttpModule
{
	public class CustomApplicationMaster: IHttpModule
        {

	        public void Init(HttpApplication context)
		{
			context.PreRequestHandlerExecute +=
				new EventHandler(context_PreRequestHandlerExecute);
		}
		void context_PreRequestHandlerExecute(object sender, EventArgs e)
		{
			Page page = HttpContext.Current.CurrentHandler as Page;
			if (page != null)
			{
				page.PreInit += new EventHandler(page_PreInit);
			}
		}

		void page_PreInit(object sender, EventArgs e)
		{
			Page page = sender as Page;
			if (page != null)
			{
				if (page.MasterPageFile != null)
				{
					if (page.MasterPageFile.Contains(”application.master”))
					{
						page.MasterPageFile =
							“/_catalogs/masterpage/CustomApp.master”;
					}
				}
			}
		}

		public void Dispose()
		{
		}
	}
}

3. Firmar el código y hacer el “deploy” copiando la librería generada *.dll al GAC.
4. Abrir el archivo web.config (usualmente localizado en Inetpub\wwroot\wss\VirtualDirectories\<NombreDelSitio>).
5. Agregar la siguiente línea en la sección de “HttpModules”:

<add name=”HttpModuleChangeAppMaster” type=”HttpModule.CustomApplicationMaster,
HttpModule, Version=1.0.0.0, Culture=neutral, PublicKeyToken=ei8798sad32jkd873″ />

6. Copiar el archivo (nombrándolo CustomApp.master) masterpage de SharePoint (application.master) a la galería de MasterPages de tu sitio. Está en Site Settings> MasterPages.
7. Y ahora sí, ya tienes tu propia masterpage de aplicación! y puedes personalizarla abriéndola desde SharePoint Designer o cualquier editor para cambiar el estilo.

Espero que les sirva!

Saludos!!!

Espero que hayan pasado felices fiestas, y que el año que empieza sea de prosperidad y armonía para todos ustedes

Este año 2010 es muy especial para mí, tanto personal como profesionalmente. En lo personal voy a empezar una nueva etapa en mi vida y espero que me vaya muy muy bien y en cuanto a lo profesional… ya llegó SharePoint 2010!!! la verdad está muy padre todo el cambio que se le dio desde MOSS 2007, trae demasiadas cosas!!

No se ni por donde empezar, pero de los “features” que se me hacen más interesantes son: el Development Dashboard, la nueva Búsqueda, PowerShell, el Health Analyzer, los correlation ID’s en las listas, el nuevo SharePoint Designer 2010 (cambio mucho!), la integración más tangible con los demás productos de Office 2010 (Visio, Access, Infopath, Excel!), los Services Applications en lugar de los ahora obsoletos Shared Services Provider!!

Jajaj en fin, son demasiados temas y todos se merecen su propio post

Regresé de vacaciones esta semana, y empecé con el pie derecho: en el curso de SharePoint 2010 IT-Pro Ignite entonces prometo postear sobre esto en los próximos días.

Les mando muchos saludos, que estén bien!

Lo primero es crear un tipo de carpeta especial, para poder agregarle una imágen o ícono, y descripción, ligas, etc.

Para hacerlo necesitas:

1. Agregar un content type (para hacerlo ve a SiteActions, Site settings, Modify all site settings) de tipo Folder, que contenga un campo extra (o los que quieras agregarle)

2. En este caso, yo agregué dos columnas: Icon (hyperlink or picture) y Folder description (multiple lines of text)

Una vez que el content type está creado, puedes ir a tu librería, y editar la configuración, entrando a: Document Library Settings, Advanced Settings, y seleccionar “Yes” en la opción ‘Allow management of content types’. Aparecerá la sección de “Content Types“, y aqui puedes agregar el recién creado “Extended Folder“.

3. Ahora, al dar click en el botón “New” de la librería, aparecerá la opción de crear una carpeta extendida (Extended folder). Crea tus librerías, y asegúrate de llenar la información de ”Icon” (link a una imagen) y “Folder description” (descripción de la carpeta).

4. Una vez que tengas todas las carpetas, lo siguiente es hacer la “vista” que te permitirá acomodar la imágen y descripción de la carpeta. Para eso vamos a usar el “content query web part” (CQWP). Se puede crear una página diferente para tener esta vista, o puedes usar la misma (AllItems.aspx), solo hay que dar clic en Site Actions, Edit Page… y agregar el CQWP al placeholder principal.

5. Ve a tu librería de estilos de XSL para agregar una plantilla, la cual aplicaremos en el siguiente paso al CQWP que acabamos de agregar.

Nota: la edición de estilos con XSL es un tema completo, que dejaré para más adelante, pero por lo pronto les dejo una página muy buena para que se den una idea de como hacerlo, sólo que está en inglés.
6. Ahora puedes aplicar el estilo que creaste en tu CQWP, sólo usa el filtro para ver los elementos de tu lista (la que contiene los “Extended Folders”) y aplica tu estilo XSL, así:

Y listo, tu vista de carpetas tiene un estilo muy personalizado ahora

Espero que les haya servido… saludos!!!

Hay varios blogs que hablan sobre las diferencias puntuales que hay entre WSS y MOSS, pero les quiero comentar sobre las pocas con las que me he topado en estos proyectos, y cómo las solucioné

Creación de sitios. Hay varias plantillas de sitios que puedes bajar e instalar para WSS, pero lo que no vas a encontrar es la plantilla de publicación. Ésto es algo que sólo MOSS tiene, por lo que tendras que trabajar con las plantillas de colaboración que provee WSS, como los “Team Sites“.

Site manager. Esta es una de las cosas que daba por hecho al usar MOSS, el personalizar la navegación y el “look and feel” con simples dropdowns, etc. Con WSS, lo unico que tienes es un editor de “top navigation” y del “quick launch” y esta es toooda la navegación que necesitas. Para el cambio del tema que propone SharePoint out-of-the-box, como el default, wheat, etc, puedes cambiar la masterpage que tiene el sitio (default.masterpage) y listo, le das el estilo que quieras. Si además quieres que todo el sitio (incluyendo las páginas de aplicación, que usan el “application.master”) tenga tu nuevo tema, puedes hacer uso de un pequeño truco, usando un HTTPModule en el archivo web.config de tu sitio, y un pequeño código como el siguiente:

using System;
using System.Web;
using System.Web.UI;
using System.IO;

namespace ChangeAppMaster
{
public class MasterPageModule : IHttpModule
{
public void Init(HttpApplication context)
{
context.PreRequestHandlerExecute += new EventHandler(context_PreRequestHandlerExecute);
}
void context_PreRequestHandlerExecute(object sender, EventArgs e)
{
Page page = HttpContext.Current.CurrentHandler as Page;
if (page != null)
{
page.PreInit += new EventHandler(page_PreInit);
}
}
void page_PreInit(object sender, EventArgs e)
{
Page page = sender as Page;
if (page != null)
{
if (page.MasterPageFile != null)
{
if (page.MasterPageFile.Contains(“application.master”))
{
page.MasterPageFile = “/_catalogs/masterpage/CustomApplication.master“;
}
}
}
}

public void Dispose()
{
}
}
}

Tienes que crear un archivo “masterpage” en tu galería, llamado “CustomApplication.master” (o el nombre que tú elijas, siempre que cambies esta información en el código de arriba) y luego de copiar la librería de código en el GAC, se tiene que agregar algo como esto en el archivo web.config:

<httpModules>
…
<add name=”AppMasterChange” type=”MasterPageModule, MasterPageModule, Version=1.0.0.0, Culture=neutral, PublicKeyToken=3ndu7331dkm11783″/>
</httpModules>

Workflows. Algo que no he solucionado aun, es el uso de workflows de aprobación, que vienen por default en MOSS, y que WSS no trae. Lo único que he hecho es activar la aprobación un elemento cada vez que se sube a una libreria/lista, y eso es todo.

Content Query Web Part. Uno de los web parts más versátiles es sin duda el Content query web part (CQWP), sin embargo, solo MOSS tiene la version de este elemento, y en WSS lo que podemos utilizar es XML para imitar el comportamiento de este web part.

En fin, supongo que hay otras limitantes con WSS, pero hasta el momento, en estas dos semanas de trabajar en mis proyectos, las más importantes han sido las que les acabo de comentar

Espero que les sirvan… saludos!

Lo mejor, es que esta solución es un “Feature”, quiere decir que puedes activarla y desactivarla despues de crear tu blog, y es fácil y rápido. Solo necesitas bajarla, descomprimir el archivo zip en el servidor, y correr el instalador (.bat) y seguir los pasos de la activación.  Así, de tener un blog como este:

Puedes tener un blog como este, y seguir utilizando las bondades de SharePoint!

Si los estilos que trae la solución no les gustan, o de plano quieren usar la solución con su propio diseño, siempre pueden modificar los archivos con SP Designer abriendo su sitio de blog http://<NombreDelServidor>/<Blog>/, y luego modificando uno de los estilos que trae la solución (Default, Summer, Wildlife, etc)
La imagen de abajo muestra algunos de los archivos que deberán de modificar:

Espero que les sirva la información

Saludos!

Aquí les presento una pequeña lista de reglas que son fáciles de seguir, si se planean desde el inicio del diseño de su sitio público, usando SharePoint.

Código semántico. Es muy importante que se traten los elementos de HTML adecuados, como los encabezados, usar <h1> hasta <h6>. Usar el elemento de lista si se tiene que agrupar algo como lista: ordenada <ol>, desordenada <ul> o listas definidas <dl>.

Usa las bondades de las Librerías de Imágenes de SharePoint. Es muy importante para SEO usar los atributos de ALT y TITLE para las imágenes de un sitio. Esto ese algo que SharePoint te provee por defecto en sus “Picture Libraries”.

Densidad de palabras clave, o Keyword density. Puedes checar mi post pasado, donde hablo de una solución que te permite agregar propiedades como Meta Keywords, y Meta Description a las páginas de SharePoint. Es importante que todas las palabras que se agreguen en las “keywords” existan realmente en el contenido de tu página. El mal uso, o el abuso de estas propiedades, son “castigadas” por los buscadores (sobre todo Google) ignorando parcial o totalmente la página, asi que ojo!

Texto descriptivo en las ligas. Trata de usar una descipción entendible en las ligas, y usa los atributos TITLE y Tooltip! SharePoint te proporciona un Web part muy util para lograr esto, y es el “Summary Link Web Part”. Como se muestra en la imagen de abajo, con este web part solo tienes que llenar los campos de los atributos y listo.

URLs amigables. Trata de que las direcciones a las páginas (URL) de tu sitio se describan por si mismas, y que no sean códigos o identificadores sin sentido. Hay una solución genial en CodePlex, que solo instalas en tu sitio y te permite cambiar los URLs de los posts de los blogs, para que sean descriptivos

Hay muchas mas cosas que se pueden implementar, y que SharePoint te facilita, pero lo podemos dejar para otro post

• Uso de un archivo de robots
• Uso de workflows para actualizar tu mapa del sitio
• Sitios y subsitios en SharePoint. Esto es una muy buena forma de organizar tu contenido, y algo que a los buscadores les gusta.

Por ultimo, me gustaria enumerar algunas práctias a evitar cuando planeas y construyes tu sitio public usando SharePoint:

1. Nombrar a las páginas con el mismo nombre (page title)
2. Incluir una sola palabra clave (keyword) repetidamente en el contenido de tu página. Si se hace esto el buscador puede descartar la página por calificarla como “sospechosa”.
3. No utilizar campos escondidos con palabras clave, de manera que no sean visible para el usuario pero si para el buscador, esto tampoco le gusta a Google
4. Usar redireccionamientos temporales.
5. Trata de simplificar las páginas de contenido, no usar estilos ni javascript “en-línea”, es mejor llamarlos o hacer referencia a ellos en un archivo aparte.

Espero que la información sea de utilidad.

Me sirvió mucho porque ademas de la explicación del código y todo el rollo, trae un archivo .wsp, que me permitió agregar e instalar la solución en mi servidor, para luego activar el “feature” y listo!.

Los pasos son bien sencillos:

1. Primero tienen que bajar la solución e instalarla en su server (activar el feature en su aplicación).

2. Luego crear “Site columns” de acuerdo a lo que necesiten:

• Meta Keywords
• Meta Description
• Meta Author
• Meta Copyright
• Meta Robots
• Meta Expiration
• Meta Refresh

Los nombes de las columnas tienen que ser exactamente igual a los de la lista.

3. Agregar las columnas a su librería de páginas.

4. Asegurarse de que en su masterpage exista el DelegateControl, ControlId=”AdditionalPageHead” asi:

<SharePoint:DelegateControl ID=”DelegateControl1″ runat=”server”
ControlId=”AdditionalPageHead”
AllowMultipleControls=”true”/>

Ahora al crear una nueva página, pueden llenar los nuevos campos con la información que quieran mostrar en cada META tag.

Espero que les sirva igual que a mi

Saludos!

La verdad es muy útil cuando por ejemplo Google tiene en cache una página de tu sitio que ya no existe, o cuando el usuario se equivoca al teclear el URL directamente en el explorador

Aquí les van los pasos para tener su página personalizada de Error 404 con SharePoint

1. Primero deben de crear una página en su librería de Pages en SharePoint, la personalizan con el estilo de su sitio, y le ponen un mensaje de error o de página no encontrada. En mi caso cree la pagina Error.aspx.



2. Ahora  en el servidor donde tengan el sitio de SharePoint, en el folder de Layouts (%systemdrive%\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\TEMPLATE\LAYOUTS\) se crea una pagina  ASPX para redireccionar a la página personalizada de error. Por ejemplo, yo creé redireccionar404.aspx.
   Esta pagina debe tener el código de redireccionamiento a su página de SharePoint. En mi caso, usé un simple javascript:

<script type="text/javascript">location.href="/Pages/Error.aspx";</script>

3. En la misma dirección de Layouts, hay un folder llamado  \1033 . Aqui se localiza el archivo sps404.html, se tiene que hacer una copia de este archivo, y guardarlo con un nombre representativo, por ejemplo: miSitio404.html
   Este archivo contiene un script de redirección STSNavigate, y tenemos que cambiar el parámetro que trae por default (“/_layouts/spsredirect.aspx?oldUrl=” + requestedUrl) por la dirección de la página redireccionar404.aspx. Esto es:
   STSNavigate("/_layouts/redireccionar404.aspx");
4. Hasta aquí hemos hecho solo el redireccionamiento (en dos pasos) hacia nuestra página de Error.aspx, ahora tenemos que decirle a SharePoint que la página de “FileNotFound” es miSitio404.html y no sps404.html. Para esto, crearemos una pequeña aplicación de consola para asignarle esta propiedad (FileNotFoundPage) a nuestra Web Application.
5. El programa de consola sería algo como esto:

string uriString = "";
Console.WriteLine("Uri String: ");
uriString = Console.ReadLine();
System.Uri webApplicationUri = new Uri(uriString);
SPWebApplication webApplication = SPWebApplication.Lookup(webApplicationUri);
string fnfPage = "";
Console.WriteLine("File Not Found Page name: ");
fnfPage = Console.ReadLine();
webApplication.FileNotFoundPage = fnfPage;
webApplication.Update();

6. Solo hay que correr la aplicación en el servidor donde esta el sitio, y proporcionar los parametros adecuados.
   
7. Y listo, la próxima vez que busquen una página que no existe en su sitio, SharePoint los redireccionará a Error.aspx

Pues como ultimo tip, si hacen una prueba con una página de extensión asp, pueden esperar ver el error amarillo “The following file(s) have been blocked by the administrator”:

Tal vez ya lo saben, pero por si no… para agregar archivos bloqueados, tienen que ir a Central Administration, Operations, y en el apartado de Security Configuration, seleccionar Blocked file types.

Luego de asegurarse que el sitio en cuestion esta seleccionado en el dropdown de la derecha, borrar de la lista el tipo “asp” (o el que necesiten) y seleccionar OK.

Espero que les sea de ayuda

Saludos!!

Creo que hoy lo decidí. Voy a tratar de escribir regularmente sobre SharePoint (ok, se que no suena lo mas emocionante del mundo)  la verdad es que me he topado con un montón de cosas que se pueden hacer con SP y no es tan feo como parece.

También me di cuenta que la mayoría de los posts que he visto sobre SP están en inglés, entonces trataré de escribir en español tanto como sea posible (aunque batalle para acostumbrarme a teclear ALT+### ).

Luego de la breve y nada elocuente introducción, les paso un par de sitios que me gusta seguir, porque siempre tienen cosas interesantes sobre SharePoint.

Social Media Talk
SharePoint Joel
Sharing the Point