Skip to main content

Elumenotion Blog

Go Search

 
Elumenotion > Elumenotion Blog > Posts > SharePoint Skinner Overview
SharePoint Skinner Overview

NOTE: This is for the OLD version!
If you have downloaded the tool since September, 2009 these instructions are out of date. For the new and far better version, see
--> this post <-- !!!

It's probably worth pointing out that though this tool was developed to make creating themes for SharePoint easier, it works with any website and has no real dependencies on SharePoint.

Download it here

Source Code on CodePlex  

 

 

Opening a Page

When you fire up Skinner, the first thing you need to do is enter a site and click 'GO'. If your site doesn't allow anonymous access you will be prompted to log and once you are authenticated the page will display and the color palette will replace the splash image in the tool pane.

There are three palettes available that you can access from the View menu: Colors, Images, and Matching Styles.

The Style drop down lists the style sheets in use on the current page. The selected sheet controls what is displayed in the tool pane and is the sheet that is being 'edited'. This is important because most operations depend on this selection, including Open, Save, and Export.

I recommend that you apply one of the built in themes and use it as your basis when creating a new theme because the resulting theme file will be much smaller.

When you change the selected style, the contents of the tool pane will update to reflect the current selection.

Using the Color Palette

Once the page is displayed and the style is chosen you can begin editing. The color palette shows all of the colors in use in the style sheet and the number of styles that use each color. To change a color, click the new color button.

For example, to change #356a5 in the 126 styles it appears in to some other color, click the #356a5 'New Color' button.

The following dialog will appear:

Notice that all the styles are listed. Most of the dialogs do the same thing. You can click an individual style and edit it individually or you can enter a color or click the colored button to use a color picker. If you type 'Red' and click save, all of the styles will be modified to use red instead of #356a5.

 

 

 

 

 

 

 

 

If you don't like the way it looks, click the Original Color button and you will be prompted to revert to the original color.

Using the Inspector

If, like me, your eyes aren't good enough to just see that the color of the text we changed in the previous example was #356a5, you can use the inspector tool to find the styles that go with the elements you want to alter. To open an instance of the inspector, click the Inspector button on the navigation bar. You can have more than one inspector open at a time. The tool looks like this:

The inspector has to modes available via the mode menu, MouseOver and ActiveElement. With MouseOver, the contents of the Inspector will change as you move the mouse over the page to represent the element under the mouse. Left clicking will lock the display and unlock the display. Active Element updates the window whenever you click on an element.

Note the Navigation Blocked button on the main window. This is a toggle and when it says Navigation Blocked, clicking on hyperlinks will not cause navigation. This allows you to use the inspector to look at hyperlinks. Occasionally, it is difficult to find the style you want using this tool, for example, some of the gradients that have other elements floating over them are hard to get at, and other elements have hover styles that obscure the underlying styles when using a mouse. The IE Developer Toolbar makes a great compliment to skinner when such a situation arises.

In this example I have clicked on the Title Area Image. It uses a style called .ms-titleimagearea. This style is defined in core.css, but not in the built in Granite theme used in this example. As a result, I am prompted to add the style.

 

 

 

Choosing yes causes the style to be added to the style sheet and the Style Editor Dialog appears. I'm going to hide any elements that use this style by entering display: none; and clicking save.

 

Note that you must enter css as text in this window. Skinner does not include a visual style builder. The reason for this is that the one in Visual Studio is excellent and is even included in the free Visual Web Developer Express Edition.

 

The Image Palette

From the View menu select images. The tool pane will change to show the images used in the currently selected style sheet.

Most of them are very small elements used as repeating backgrounds with dimensions usually 1px wide. However, the palette shows the name of the image and a thumbnail. Clicking the url opens the image editor.

The editor gives you the option to save the image to disk for editing, replace the image with a different image of your choosing and the ability to open the style editor for the style that includes this image. In this example we will replace the image. Clicking replace opens a file dialog that you can use to pick the new image.

 

 

 

 

 

 

 

 

 

I also want to specify that this image will appear at the bottom in the background. When I chose replace the style was updated and the Image Viewer closed. Reopen it and click the link to open the style editor.

Edit the style to specify the desired positioning.

 

 

 

 

 

 

 

Note that the url to the image is wherever the file is that you selected. None of the preceding examples has actually done anything to the CSS on the SharePoint server. Everything is taking place locally. When the time comes to create the actual theme everything gets fixed up nicely. This involves copying the images to the theme folder created on export. So, don't move your images or the copy won't work.

Finally, if you decide that you want to remove an image that exists in the core.css, you must specify background-image: none. The way css works is by looking at the last rule in the list. Themes simply override what's in core.css. If you just delete the rule, whatever is in core.css is applied.

The Matching Styles Palette

The Matching Style Palette is the final tool pane available via the View menu. It simply displays a list of classes in the current style sheet that apply to elements on the current page. This view can make finding the style you want to affect much easier and is also a pretty good way to explore the styles used on given types of pages. When you take the next step in branding and start creating custom master pages, content pages, etc., you will want to use the correct styles if you want users to be able to use any of the built in themes to good effect.

Saving Your Work and Navigation

As noted in the discussion of the image palette, all of these edits are actually taking place locally and have no effect on the server. In fact, they aren't even persisted until you save your work. You have the option of doing so in the file menu.

You will want to do this often because whenever you navigate, the styles will revert to what is on the server. If you toggle the Navigation Blocked button and click a link you will receive a warning.

Save your work before navigating. Use file open and reapply your changes. This will allow you to create styles visually for the rules that had no match on the previous page.

Exporting the Theme

Select Export Theme from the File Menu. Give your theme a name that will be used on the SharePoint server, pick a directory, and viola! You have a theme. Now all you have to do is install it.

Installing the Theme

To add the theme to a site, copy the created directory to:

C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\THEMES

 

Open:

C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\LAYOUTS\1033\SPTHEMES.XML

   

Copy the bottom section and modify it as appropriate (it's very simple).

Recycle your app pool and bada-bing! Go to your site settings and apply the theme.

Note: When you apply a theme, it gets copied for your site. If you subsequently edit it, you need to recycle the app pool, apply a different theme to your site and reapply your theme with any changes!

That's it. I hope you like it. I think it works pretty well. The themes for this site were created using this tool.

Author: Doug Ware

Comments

Very Cool

This is just what I needed! Thanks!!!
Anon at 8/26/2007 9:11 AM

Sahil Malik

VERRY NIICEE !! HOW MAACH!!
Anon at 8/27/2007 8:35 AM

Doug Ware

Good question! It's free. I'll probably put it up on codeplex when I find the time.
Anon at 8/27/2007 8:50 AM

Great!!!!!!!!!!!!!!!!

ThanKs It is great
Anon at 8/28/2007 6:07 AM

http://www.cjvandyk.com/blog

Awesome looking tool!
I can't wait to try it out.

Later
C
Anon at 8/31/2007 7:43 AM

Kudos!

Very, very nice tool. Light weight and extremly easy to use.
Thanks

http://shamanovsky.com
Anon at 8/31/2007 4:27 PM

This looks amazing

I can't wait to try it.  I appreciate your initiative.

http://autosponge.spaces.live.com/
Anon at 9/5/2007 8:29 AM

image permission problem

i can't seem to load the images, i get 401 permission errors on all of them, no matter if i use built in theme or custom theme.
Anon at 9/7/2007 11:27 AM

Thanks for this tools

Anon at 9/18/2007 2:09 AM

image permission error also

i also receive the 401 permission error when trying access the images. the thumbnails also therefore dont show up either. this strange because the account I'm using is a local admin as well as the portal admin

any help would be appreciated
thanks
Anon at 9/26/2007 5:52 AM

Image Permissions

Do the images show up when you try to browse the site using a browser and the same login?

Is it a problem with every theme or just the theme you created?

Please email me, dougw@thesharingpoint.com.

--Doug
Anon at 9/26/2007 7:00 AM

Wow

I still haven't used it but this looks like what i needed. Seems pretty cool!
Anon at 9/26/2007 12:08 PM

Image Permissions

With some help one cause of this was reproduced today. In this particular case it was caused by an untrusted ssl certificate. Skinner uses a plain .Net PictureBox control and if it can't verify the cert it will fail.

I am researching a fix, but in the meantime, https is an issue unless the cert is verifiable and valid.

If you are getting this error and ssl is not involved then please email me.

--Doug
Doug at 9/27/2007 2:40 PM

You should get paid for this!

What an awesome tool.  I'm particularly loving the Inspector.  Thank you so much for sharing this; I would buy it if I could.
Anon at 10/2/2007 2:30 PM

Image load issue

when I click on an image url , I get permission denied 401 error.  I am not using SSL. 

Any idea how to fix this error?
MOSS Designer at 10/12/2007 10:05 AM

Images not loading here either

Great product!  Love it!  Everything working perfectly except images.

401 errors on all images ... I am not using SSL ...
John at 10/18/2007 11:22 AM

Can't get Website to show

I've typed in the Website address at the top but I'm getting an error saying the program cannot display the webpage.
I've tried a couple of our SharePoint sites and none seem to work.
My internet connection is fine and although our site doesn't allow anonymous access, the authentication details are not showing.
This software looks great (even better because it's free!) - annoying that I can't use it yet!

Please help!

Mel at 10/24/2007 1:44 AM

Mel

Hi Mel,
Sorry to hear you're having trouble. Are you able to access sites with the tool like msdn or google? Drop me an email please.

You probably have a proxy server or other network appliance that full blown IE deals with, but that the web browser control doesn't.
Doug Ware at 10/24/2007 9:31 AM

Any Luck on the Images?

Seems the images don't show for the site specific CSS.
The core.css images seem to render fine for me, just not the actual theme (i.e. Breeze) in the image palette
Mike at 11/1/2007 2:33 AM

Images

I#ve got the problem that the images do not show, too. My OS is Vista and I do not use SSL but everything else is really cool.
Werner at 11/6/2007 3:23 AM

Very cool in deed !!!

Thanks much appreciated.
Any one considered extending SharePoint Designer with these types of functionalities?
Filou at 12/15/2007 6:22 AM

Excellent tool

Just used this to help adust my css to add a new logo, would have been a pain without it.

Many thanks,
Colin.
http://randomelements.me.uk
Colin Walker at 1/5/2008 11:11 AM

Very cool in deed

This looks amazing. Just used this to help adust my css to add a new logo, would have been a pain without it.
http://insurance.ireporter.tv
Casey Shedd at 1/12/2008 7:26 PM

What about undo's?

I just downloaded the skinner and it seems like I'll eventually learn how to work it. But if I'm changing images...I need an undo button if I change something and don't like it. (it it wasn't where I thought it should be hcanged at).

I look forward to learning more as I continue to play with it and make my pages look more like our company colors!
Rita at 1/25/2008 11:17 AM

Really cool stuf

This is very amazing. I'll try it soon and put it on my blog http://cakriwut.wordpress.com
Cakriwut at 1/28/2008 11:02 AM

Everything's Great Except It Doesn't Work

I love this tool. I wish I found months ago. The only problem the changes I make aren't reflected on the site (or on the preview within Skinner). Am I missing something?
Rich at 1/31/2008 2:34 PM

@Rich

Rich,
Lol, you have to actually export the theme and install it on SharePoint per the instructions.
Anon at 1/31/2008 2:51 PM

Brilliant!

Just discovered this (again, I had used the 2.0 version) and this is awesome. Please put it up on CodePlex or somewhere as there are some cool things that could make it even better (like when you click on a style rather than have a free form editor, parse the style into a property editor ala TopStyle)
Bil Simser at 2/7/2008 11:16 AM

Very cool, but I'm having problems with Image Permissions.

Neat tool, but like some of the others I'm getting 401s on the images specific to the Theme on the site.

The default images are fine, and the page renders with the current theme correctly, but the Images view get's 401s on all images related to the site's current theme.

Essentially, this is the same as Mike above.

I'm not using HTTPS.
Andy Burns at 2/11/2008 7:26 AM

Permission Problem

Hi Andy,
See this post for more information and an easy workaround. http://www.elumenotion.com/Blog/Lists/Posts/Post.aspx?ID=27

Let me know if you still have issues.
Doug Ware at 2/11/2008 6:17 PM

Cool Man

This is just what I needed! Thanks!!!
...lol...

Daniel Garcia at 3/6/2008 8:16 PM

Guys like you make guys like me look good

Thanks for the tool!  EXACTLY what I needed. 
MRG at 3/13/2008 11:27 AM

Multi Style Sheets

Hello love the program, but have a question.

I'm making modifications to several style sheets, and discovered that I need to save each under a different name.  When I then export the theme it only exports the last style sheet loaded in.  Am I doing something wrong?

Thanks in advance for any help
Andrew Barnes at 4/16/2008 6:23 AM

RE: Multi Style Sheets

Hi Andrew,

The theme for this site includes styles from both core.css and calendar.css.

What I did was.
1. Select the sheet I want
2. Make my changes
3. Save my work
4. Navigate to another page or select a different sheet
5. Load my work
6. Continue

I intend to include better support for this scenario in the next version (someday).
Doug Ware at 4/16/2008 7:53 AM

Multi Style Sheets

Doug

Thanks for that.

Sorry if this is a bit dim (I'm more graphics than code!)

So if I export the theme paste in any additional code (from the other style sheets I have modified), change the image locations, is that it?  Do I need to do anything else?

Thanks again for your time
Andrew Barnes at 4/17/2008 3:47 AM

RE: Multi Style Sheets

That should do it Andrew.

A couple of tips.

1. If you have already installed the theme on the server, run iisreset to clear the cache after you update the files.

2. If you applied the theme to a site already, change to a different theme and then reapply your theme to get the changes applied. You do this because setting the theme actually copies the theme to the site from the disk. So, just changing the files on the disk will not affect the site.
 
Doug Ware at 4/17/2008 11:21 AM

Can help me allot

Doug, I have a problem when I try to apply the theme to a site after I've recycled my app pool, I get the following error Can not open folder "Name of Folder"

Can you tell me what I've not done.
Troy Jackson at 4/29/2008 4:22 PM

Can help me allot

Doug, I have a problem when I try to apply the theme to a site after I've recycled my app pool, I get the following error Can not open folder "Name of Folder"

Can you tell me what I've not done.
Troy Jackson at 4/29/2008 4:34 PM

RE: Can help me allot

Troy,
My guess is that you either have the application pool running under an identity that doesn't have permissions to the folder or that the name you used in the SPThemes.xml file.

Doug Ware at 4/30/2008 2:47 PM

Theme name and version already exist error.

Doug,

Great tool, I was able to modify Obsidian much easier then on my first attempt, however after I have restarted IIS, when I try to apply my theme to the site I get the error:

A theme with the name "FITObsidian 1011" and version  already exists on the server.

Is there something else I need to do?
ELC at 5/1/2008 10:25 AM

Re: SharePoint Skinner Overview

Hi,

I was having the same problem when I had spaces in the theme name. When I used a theme name that didn't have any spaces it worked fine.
Ali at 5/6/2008 8:49 AM

Thanks, great tool, we added it to SharePoint-tools.de

Here's the PermaLink <a href='http://www.sharepoint-tools.de/75/SharePoint_Skinner.html'>SharePoint-Tools.de</a>
Oliver at 8/14/2008 11:54 AM

Sharepoint Skinner

I like the idea of this - it is nice.  The problem that I have is that I get the theme up and make changes, the problem is that the changes that I am making do not reflect in the skinner.  I undersatnd that it will not show up on the site until I export it and install it.  But shouldn't it be reflecting my changes in the skinner?  Am I doing something wrong.  I am really excited about this tool!  Any help would be great!
Ward at 10/2/2008 8:51 PM

Great tool!

I just wanted to say, great job on this! VERY useful... and a real time saver. I'm using this in conjunction with a variation of STSDEV for redeployment with my changes, and this combo is terrific!
Michael Bell at 11/3/2008 10:23 AM

Great Solution!

Keep going like that, folks!

Fabian at 11/26/2008 9:53 AM

Re: SharePoint Skinner Overview

Creative. good job
Saber Hormi at 1/13/2009 9:22 AM

Great solution but has bugs

Hi, this is a good solution but when I try to charge the css images it fails and I don't know how to solve it!!
Josep at 1/15/2009 4:28 AM

Can't change css in Style Editor

Hi, I'm having problems changing any styles in the Style Editor. I get a pop up window that says:
An error occurred. Check your syntax! Error Error HRESULT E_FAIL has been returned from a call to a COM component.

I get this error even if I try and save an unedited style in the Style Editor.
Sonnerz at 2/3/2009 7:31 AM

elearning course

Hi, I will appreciate if someone knows of a GOOD online sharepoint 2007 course.

thks....
SANDY at 2/27/2009 7:17 AM

Thanks!

Thanks due, your tool saved my ass!  PS: Consider adding one more image to this article that shows the theme applied to a site. W/ out such a photo it's kind of anti-climatic.  Again, thank you!
Anon at 4/10/2009 8:10 AM

Thanks Doug!

SharePoint Skinner is great! 
Gary Martin at 5/19/2009 3:16 PM

Thank Ya!!

This is just what we need
NitipumS at 6/10/2009 1:25 AM

Thank you!

This is a wonderful program. I'm not expert at Sharepoint, and found this when I was struggling with customizing a 3.0 site to be similar to my 2.0 version.  This really helped give me a good understanding of how themes work.  It really helped in a smooth transition.
Noel at 8/15/2009 6:18 PM

BROKEN! Can you look into this?

These instructions suggest we should apply an out of box theme and then customize it. When I go to a site with an applied theme, and click on to Images from the drop down - the image files do not show up, and when I click to edit them the app crashes with an auth error of some sort "401 Unauthorized" This only happens when you apply a theme on the site and try to change an image..
Anon at 8/26/2009 9:29 AM

RE: BROKEN! Can you look into this?

Funny you should mention that, the new version does indeed fix that problem. Look for a new tutorial very soon.
Doug Ware at 9/4/2009 12:39 PM

I messed up! HELP!

Okay, rather than coming back here to RTFM, I deployed the wsp through stsadm. I know, stupid of me.  But now, I cannot change themes because I get the following error:

Failed to enable constraints. One or more rows contain values violating non-null, unique, or foreign-key constraints.

I know it is a SQL database/key problem, but I have no earthly idea where to go to fix/look at it. Any ideas?  OR, and ideas how to put the default theme set back in place and then I will follow your steps when I edit a site in the future. LOL

Thanks for ANY help you can give...
--David at 9/17/2009 12:14 PM

RE: David

Sorry to hear that David. You should be able to deploy the wsp with stsadm just fine. When the feature installs, it modifies the spthemes.xml file in 12\Template\Layouts\1033. So whatever is wrong should be visible in that file and easy to correct.

Also, what build are you running? Check the About box. There was a bug in the early 2.0 release with regards to the feature code. Send me an email at dougware@elumenotion.com and we'll get you sorted out.
Doug Ware at 9/18/2009 11:58 AM

Thanks and help again...

Okay, you were right - just modified the XML back and that fixed it! Thanks!

Now, when I try to install a theme, I get an error that says:
A theme with the name "PPSTheme01 1011" and version  already exists on the server.

No matter what I rename the theme to, I get this error... Any ideas? Thanks!
--David at 9/24/2009 10:28 AM

RE: David

Make sure you have retracted and uninstalled the wsp and then check for the presence of your PPS Theme in 12\Template\themes. If it is still there after you uninstall the wsp, delete it. After that make sure you have the newest build, rerun your export and you should be good to go.
Doug Ware at 9/24/2009 11:48 AM

Your reply to David helped me too.

I messed up my SPTHEMES.xml too and I was not having any idea why I am not able to see themeweb.aspx. Your reply to David gave me idea of checking SPTHEMES.xml file. It fixed the issue.
Thanks a lot.
Yogi at 10/25/2010 4:48 PM

Re: SharePoint Skinner Overview

Useful & informative article - thumbs up, keep going your good work, buddy.

Chris
Chris at 7/29/2011 8:44 AM

Add Comment

Items on this list require content approval. Your submission will not appear in public views until approved by someone with proper rights. More information on content approval.

Title


Body *


Your Name *


Attachments
Follow me on twitter!
The Atlanta .NET User Group
MVP Logo
  Archive
  Archive (Calendar)
  Skinner Created Themes
  New Skinner Download
  New Skinner Tutorial

©  2009 Elumenotion, LLC  |   SharePoint Training, SharePoint Consulting and SharePoint Staffing
8075 Cavendish Place | Suwanee, Georgia 30024 | + 1 (888) 653-5021