SPB usage guide – 1 Download and Installation


SPB usage guide – 1 Download and Installation

This is the guide on how to install and use the SharePoint Branding Project.
Download: Visual Studio gallery

The guide is devided into three parts:

1 Download and Installation

2 Configuration and Modification

3 Deployment and verification (soon to be released)

Hi friends.

Allow me to welcome you on a journey to the wonderful world of SharePoint Branding. I created this SharePoint Branding Project thinking that the overhead and the learning curve to just get started with branding, was way too high. The amount of blogs to read and discard until you could actually build you very first, very basic custom branding solution, it was rediculous! Now pretty recently, the guides on Technet have been improved and most of them actually work, but it is still a long way to go if you want to start from scratch with little or no knowledge about how you go about creating such a project in Visual Studio.
With the SharePoint Branding Project, you can brand your company, organization or customer SharePoint in about 10 minutes, and you will have full control doing so. Follow this guide and you will cruise all the way to the finnish line.
To use this template, you need a SharePoint 2010 and Visual Studio on the same machine. If you can follow instructions, then you can achieve this.
Now, lets get started and have some fun, this IS fun after all!

There are two ways to download the extension file from the Visual Studio Gallery, the first is to simply go to the Visual Studio gallery, Click SPB.
Then on the large purple button, Click Download.

In the annoying but useful IE download bar, Click Open.

Click ‘Install’ to install the extension into Visual Studio.

When the extension is installed you will get a ‘Complete’ notice. Click Close in the dialog.

You are now done downloading and Installing the actual extension and you can now move on to the interesting stuff,  to create a SharePoint Branding Project in Visual Studio.
But before we go into how, we will show you another way to install the extension. From Visual Studio Extension Manager. The extension manager will show the installed extension regarless of the way you installed it, here you will also be notified of updates that have been released of the same extension.
Follow these steps from Visual Studio:

Start the Extension Manager from Visual Studio, Tools menu, Click Extension Manager

Click Online Gallery and search for SPB or browse the ‘Templates’ category and ‘SharePoint’ and you will find the SPB extension.
Click Download and the file will download and initiate the installation. Click Install in the next dialog:

When the extesion have been installed, you can’t wait to get going with the branding right. Ok, we will start that part, regardless of the way you choose to perform the download and installation, and the installation (Which is very quick) has completed, in Visual Studio, select File, New and Click Project:

In the Installed Templates section, select Visual C#, SharePoint, 2010 and SharePoint 2010 Branding Project.
Name the project (This name will also be the name of the SharePoint Feature once deployed to SharePoint), select the projects file location and Click OK.

Now you are done with the installation and can move on to the next step in this guide:

2 Configuration and Modification

or jump directly to the last step, not recommended:

3 Deployment and verification(soon to be released)

Stay tuned!

Enjoy!

Regards

Twitter | Technet Profile | LinkedIn

 

Advertisement

10 thoughts on “SPB usage guide – 1 Download and Installation

  1. Hi

    I had a thought. Normally, when I edit a master page and add/modify I want to do it quickly in SPD 2010. I guess I could still do that with the branding project master page and when I am happy export to the VS2010 project. I do have VS2010 Pro and SP2010 running locally in my vm though. I am Interesting to hear your thoughts.

    1. Hi.
      Absolutely, you can do that. Use SDP as an ‘editor’ to get the masterpage just right and then add it to the Project for ‘proper’ deployment.
      Sounds like a good idea, that way you don’t have to deploy, deploy, deploy to test every change in a testsite but you get the benefit of the SPD’s WYSIWYG design view.

      Regards
      Thomas

  2. Thanks for the confirmation. Slightly off topic for my next deployment I want to add a ref to jQuery to the master page. Nomally I use the ‘traditional syntax’ but I thought I would try the more portable script link – just wondered if you had tried this.

    SharePoint:ScriptLink language=”javascript” name=”~sitecollection/Style Library/Script/jquery-1.8.0.min.js” Defer=”true” runat=”server”

    1. Hi.
      Not tried it but I would appreciate it if you could post your feedback after you tried it?
      The Branding package will be perfect for packaging and deploying the java files as well so that could be an addon for the future. Don’t know yet how this will look in 2013 with the new branding concept there, but I assume that there will still be a need for better Tools..
      Regards
      // Thomas

  3. Thomas

    I am pleased to report back the following

    1) I checked jQuery worked with traditional style syntax
    script type=”text/javascript”
    src=”/mysitecollection/Style%20Library/Scripts/jquery-1.8.0.min.js”
    $(document).ready(function() {alert(‘hi’);});</script

    3) then I commented the above and replaced with

    SharePoint:ScriptLink language="javascript" name="~sitecollection/Style Library/Scripts/jquery-1.8.0.min.js"
    Defer="false" runat="server"/

    It works baecause sharepoint renders scriptlink with a "document.write" call with the syntax.

    Be warned: THE ABOVE SYNTAX HAS TO BE PRECISE OTHERWISE YOU GET ODD ERRORS IN YOUR BROWSER.

    1. Hi AJK
      Unfortunately not. It has been on my todo list for a very long time, but other things seem to get in the way…
      Same as a projecttemplate for 2013…and SPO.

      Regards
      // Thomas

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s