49
Tom Daly, Marcy Kellar, and Michael Mukalian and Host: Jason Himmelstein SharePoint Saturday NYC | July 28, 2012

10 Worst Mistakes in SharePoint Branding

Embed Size (px)

DESCRIPTION

Earlier this year I wrote a blog on the Top 10 Mistakes in SharePoint 2010 Branding and UI Design (http://bit.ly/ITzlJl) and had such an overwhelming response that I wanted to present it to the community. I brought in a front end developer (Tom Daly) and a Developer (Mike Mukalian) to help me convey the different perpsectives that each of our roles takes. My original list of mistakes changed a bit when we brainstormed on overall cost and commonality of branding messes. I still stand by my original listing in the blog but by adding different roles in the mix, we were able to provide a depth of experience to support these 10 costly and common mistakes in SharePoint Branding and UI Development.­

Citation preview

Page 1: 10 Worst Mistakes in SharePoint Branding

Tom Daly, Marcy Kellar, and Michael Mukalian and Host: Jason Himmelstein

SharePoint Saturday NYC | July 28, 2012

Page 2: 10 Worst Mistakes in SharePoint Branding
Page 3: 10 Worst Mistakes in SharePoint Branding
Page 4: 10 Worst Mistakes in SharePoint Branding

What You Will Get Out of this Panel

– The ability to steer clear of making big mistakes

– An opportunity to ask questions and share your experience

– The excitement of watching the MAGIC between different roles

Page 5: 10 Worst Mistakes in SharePoint Branding

Panel Contact Information

Designer Marcy Kellar

@marcykellar

thesharepointmuse.com

Front End Developer Tom Daly

@_tomdaly_

thomasdaly.net

Developer Mike Mukalian

@mmukalian

www.mukalian.com/blog

Presenter
Presentation Notes
6 minutes. �APPLAUSE Jason: Introduces us: Marcy (Designer / UX) Focus is on Business Strategy, User Experience Design, Web Content Management, Graphic Design SharePoint Designer – Primary tool used for branding. Front End Dev – Copy and Paste Javascript/Jquery, XSLT – CQWP Visual Studio – Update package, hit F5 Tom (Front End Developer) Focus is on making the design work and manipulating the UI SharePoint Designer - SharePoint Branding Front End Dev - Scripting / Javascript/Jquery . XML / XSLT, CAML query Visual Studio - Custom user controls / Custom Search Results Mike (Developer) Focus is on making the system architecture and design adhere to the proper standards SPD: It has its place, but don’t hate it (that much now, 07 *blech*) FED: Scripting (JS/JQ), XML/XSL(T)/CAML VS: Architecting the solution Do you work with a lot of design folks? Who dictates where the design assets go in the soln?
Page 6: 10 Worst Mistakes in SharePoint Branding

Don’t Let the Designer Get Carried Away

What Is It? Designers have “crazy” ideas that may not translate well into SharePoint.

Page 7: 10 Worst Mistakes in SharePoint Branding

Summary:

Don’t Let The Designer Get Carried Away

• What is it? – Designers define and document a vision without considering

implementation costs and/or feasibility in SharePoint • Why is this a mistake?

– Just because you can design it, doesn’t mean it will work in SharePoint – Potential compromise of functionality

• What is the impact or cost? – Dissatisfied business customers – Inaccurate budget / timeline

• Are there any exceptions? – No – But SharePoint Branders should be involved in part of the design

process and/or should be used to provide guidance • What is the fix or workaround if I’ve already made the mistake?

– Come to “insert religious icon or choice” meeting (Come to Jesus meeting) – Work with designers /design firm that understands SharePoint

Page 8: 10 Worst Mistakes in SharePoint Branding

Impossible Drop Down Navigation

Having the flyouts render horizontal instead of vertically. This was with the 2007 table based navigation Wouldn’t work correctly in all browsers No budget + not in scope to create new navigation

Page 9: 10 Worst Mistakes in SharePoint Branding

Re-inventing SharePoint Forms

No custom code budgeted, or even possible to deploy in timeframe

People Picker

Upload Control

Page 10: 10 Worst Mistakes in SharePoint Branding

Impossible Left Navigation

• No way to accomplish this with OOTB Nav

• Need 3rd party or custom control

3 levels (impossible w/ OOTB) with expanding children on the current site

2 levels w/ grouping (Fine) with expanding children on the current site.

Page 11: 10 Worst Mistakes in SharePoint Branding

Rounded Corners

http://freecsstemplates.over-blog.com/

Page 12: 10 Worst Mistakes in SharePoint Branding

Applying Fixed Width to Collaboration Sites and System Pages

What Is It? Fixing the width of the layout on any site where users are primarily collaborating.

Collaboration Sites: • Team Site • Meeting Workspace • Document Center • Record Center • Etc..

Presenter
Presentation Notes
9 minutes. 1. Marcy to Overview Description (question 1 & 2) 2. Cue up stories Marcy story on cost - walk through screenshot examples; content spillage Tom story – overflow hide Mike Story or grumpy comment 3. Marcy overview exceptions Site architecture, one web app for publishing. Explain 4. Marcy intro workaround Change content area to 90%; display table Screenshot/ Code example Tom explain his fixing spillage workaround Mike’s question: Are we addressing that people don’t listen to these mistakes?
Page 13: 10 Worst Mistakes in SharePoint Branding

Summary:

Applying Fixed Width to Collaboration Sites & System Pages

• What is It? – Fixing the width of the layout on any site where users are primarily

collaborating. • Why is this a mistake?

– Limits space for collaboration – Users have to scroll – Content spillage

• What is the impact or cost? – User Experience – Usability

• Are there any exceptions? – Never – Must keep lists views, web parts – keep small; governance on content

• What is the fix or workaround if I’ve already made the mistake? – Width:95%;display table ;margin:0 auto; – Make system pages inherit default branding or branded without fixed width – Make inner scroll

Presenter
Presentation Notes
4 minutes. 1. Marcy to Overview Description (question 1 & 2) 2. Cue up stories Marcy story on cost - walk through screenshot examples; content spillage Tom story – overflow hide Mike Story or grumpy comment 3. Marcy overview exceptions Site architecture, one web app for publishing. Explain 4. Marcy intro workaround Change content area to 90%; display table Screenshot/ Code example Tom explain his fixing spillage workaround Mike’s question: Are we addressing that people don’t listen to these mistakes?
Page 14: 10 Worst Mistakes in SharePoint Branding

Constrained WebPart

Presenter
Presentation Notes
Design constrains the team site. Video web part - thumbnail size. Tom going to update picture.
Page 15: 10 Worst Mistakes in SharePoint Branding

System Page Issue with Fixed Width

Page 16: 10 Worst Mistakes in SharePoint Branding

Content “Spillage” on System Pages

Page 17: 10 Worst Mistakes in SharePoint Branding

Quick CSS Fix on Content Area

Page 18: 10 Worst Mistakes in SharePoint Branding

Solution: Add 95% Width instead of Fixed

Page 19: 10 Worst Mistakes in SharePoint Branding
Presenter
Presentation Notes
Solution – system pages to inherit default. Source of information
Page 20: 10 Worst Mistakes in SharePoint Branding

Collaboration Site Example

Page 21: 10 Worst Mistakes in SharePoint Branding

Using Too Many Master Pages

What Is It? Using Master Pages to manage variations and using too many.

Presenter
Presentation Notes
8 minutes. - Give prize - Ask audience who has most master pages in the room. Ask how they got there. 1. Mike to Overview Description (question 1 & 2) 2. Cue up stories Mike Story or grumpy comment Do you see why I have no hair? Too many pages to keep track of Deployment (Solution/Feature) management becomes complex Workaround Governance Consolidation initiative Marcy story and example cost (30 master pages in migration to 2010/Public SP site story with master pages managing variations instead of User Controls = dev disaster. 3 months late) Tom story 3. Marcy overview exceptions Your # of MP x Env (Dev/QA/Prod) = many master pages 1 master page per distinct design 4. Marcy intro workaround Marcy asks Tom: Would you say that you have a minimum that you use? The maximum in 2010 I’ve done 6 KISS What is the fix or workaround if I’ve already made the mistake? Enforce governance/ remove permissions Strategize – Find where each page is similar or different. Try to reduce number without too much backlash Consolidate - Take a few days to realign and consolidate the master pages. Use Notepad ++ to diff the contents of the master pages.
Page 22: 10 Worst Mistakes in SharePoint Branding

Summary:

Using Too Many Master Pages

• What is This?

– Using Master Pages to manage variations and using too many. • Why is this a mistake?

– More assets to manage – More development work – Costly and /or complex Migration

• What is the impact or cost?

– Migration and / or redesign cost and time – Consistency across sites – Hard to maintain/manage changes

• Are there any exceptions?

– “Too Many” is relative to scenario – 1 master page per distinct design and template

• What is the fix or workaround if I’ve already made the mistake?

– Enforce governance/ remove permissions – Consolidate master pages. Manage variations with page layouts, alternate CSS or

custom controls – Most of the reasons you think you need a new master page, you can use page layout or

alternate CSS

Presenter
Presentation Notes
Give prize - Ask audience who has most master pages in the room 1. Mike to Overview Description (question 1 & 2) Mike: Do you see why I have no hair? Too many pages to keep track of Deployment (Solution/Feature) management becomes complex Workaround Governance Consolidation initiative Marcy story and example cost (30 master pages in migration to 2010/Public SP site story with master pages Tom story 3. Marcy overview exceptions Your # of MP x Env (Dev/QA/Prod) = many master pages 1 master page per distinct design and site template 4. Marcy intro workaround Marcy asks Tom: Would you say that you have a minimum that you use? The maximum in 2010 I’ve done 6 KISS What is the fix or workaround if I’ve already made the mistake? Enforce governance/ remove permissions Consolidate - Take a few days to realign and consolidate the master pages. Use Notepad ++ to diff the contents of the master pages. Enforce governance/ remove permissions Consolidate Most of the reasons you think you need a new master page, you can use page layout or alternate CSS
Page 23: 10 Worst Mistakes in SharePoint Branding

• 1 Distinct Design • All sites in scope

Example Scenario

Publishing

Collaboration

Meeting Workspaces

Search Center

My Sites

Presenter
Presentation Notes
Marcy to explain this scenario
Page 24: 10 Worst Mistakes in SharePoint Branding

Master Pages

Example Scenario

Publishing

Collaboration

My Site Personal (My Content)

Minimal (Search)

My Site Host (Newsfeed, Profile)

Meeting Workspace 1 Master Page per distinct Site Template = 6 Master Pages Potential to need a separate master page for system pages.

Presenter
Presentation Notes
Marcy to explain this scenario
Page 25: 10 Worst Mistakes in SharePoint Branding

mws.css

minimal.css

mysitehost.css

Pub.css

collab.css

mysitepersonal.css

Master Pages

Example Scenario

Publishing

Collaboration

My Site Personal (My Content)

Minimal (Search)

My Site Host (Newsfeed, Profile)

Meeting Workspace

sharepoint

style.css

Base Branding

Presenter
Presentation Notes
Marcy to explain this scenario
Page 26: 10 Worst Mistakes in SharePoint Branding

Breaking the Master Page Development

What Is It? Breaking the Master Page During Development If you don’t test along the way, its get’s messy

Page 27: 10 Worst Mistakes in SharePoint Branding

Summary:

Breaking the Master Page During Development

• What is it? – Breaking the Master Page During Development

• Why is this a mistake? – There are so many ways to break the master page

• What is the impact or cost? – Broken Master Pages – Rework, Scratching an idea – Functional issues that aren’t evident until site being used. – The further along you get, the harder is to fix a break

• Are there any exceptions? – No

• What is the fix or workaround if I’ve already made the mistake? – Constantly test – Start over

Presenter
Presentation Notes
6 minutes. 1. Tom to Overview Description (question 1 & 2) 2. Impact/ Cue up stories Marcy Tom Mike Story or grumpy comment 3. Tom overview exceptions 4. Tom intro workaround Constantly test Check different browsers Web Parts Firefox Overflow Z-index Start over
Page 28: 10 Worst Mistakes in SharePoint Branding

Use Code View in SPD

Page 29: 10 Worst Mistakes in SharePoint Branding

Not Designing Around Real Content

What Is It? • Not using real content to guide the design. • Using filler / fake content

Vector Graphic courtesy of http://dryicons.com

Page 30: 10 Worst Mistakes in SharePoint Branding

Summary:

Not Designing Around Real Content

• What is this?

– A design that hasn’t considered real content; – Using non-representative filler/fake content – Using “Lorem Ipsum”

• Why is this a mistake?

– Impacts layout, growth / stretching/ empty areas – Real content helps define patterns

• What is the impact or cost?

– Rework based on real content to support actual content once migrated or created.

• Are there any exceptions?

– Sites where design dictates content or that have copywriters • What is the fix or workaround if I’ve already made the mistake?

– Set expectations that rework will occur after content is introduced. – Go back to design phase. Make changes accordingly after real content is

reviewed. Use representative content in Photoshop design – Try to anticipate areas where there could be issues by doing bounds testing. – Staging environment

Page 31: 10 Worst Mistakes in SharePoint Branding

First View of Mockup

• Marcy - screenshot of Top Nav wrap

Example of Mockup provided Use of Lorem Ipsum (Placeholder Text)

Page 32: 10 Worst Mistakes in SharePoint Branding

Fixing the Width of the Ribbon

What Is It? Fixing the width of the ribbon to match the fixed width of the content area

Page 33: 10 Worst Mistakes in SharePoint Branding

Summary:

Fixing the Width of the Ribbon

What is it? – Fixing the width of the ribbon to match the fixed width of the content area – Constraining the ribbon (a huge UX investment) to a width smaller than

100%

Why is this a mistake? – Not consistent throughout organization – Administrative tools change size, icon, location

What is the impact or cost? – Training especially 3rd party

• Are there any exceptions? – If design is very important to your organization

What is the fix or workaround if I’ve already made the mistake? – Update your implementation to expand Ribbon to full width. – Or create your own training materials to reflect the look of the custom

ribbon

Page 34: 10 Worst Mistakes in SharePoint Branding
Page 35: 10 Worst Mistakes in SharePoint Branding

Using Content Editor Web Parts for Web Content

What Is It? Using the Content Editor Web Part for Web Content

Page 36: 10 Worst Mistakes in SharePoint Branding

Summary:

Using Content Editor Web Parts for Web Content

• What is It?

– Using a Content Editor Web Part instead of using the right tools for web content • Why is this a mistake?

– No versioning of content – Not best method for managing web content

• What is the impact or cost?

– No versioning – Publishing model / Approval – Search

• Are there any exceptions?

– Foundation Server only – You Tube Videos

• What is the fix or workaround if I’ve already made the mistake?

– Plan to move most frequently changed content into RTE (PageContent Control) in page layouts

– If default SharePoint page layouts don’t work, create custom page layouts with field controls. This is the right way to do it.

– If you have a lot of web content, consider a standard or enterprise license. – In SP2010, use txt files to manage content;

Page 37: 10 Worst Mistakes in SharePoint Branding

Removing the Quick Launch ContentPlaceholder from Master Page

What Is It? Removing the Quick Launch control from the Master Page

Page 38: 10 Worst Mistakes in SharePoint Branding

Summary:

Removing the Left Nav Controls from Master Page

• What is it? – Removing the Left Navigation Controls from master page

• Why is this a mistake? – Can’t take advantage of left nav anywhere that master page is

referenced. • What is the impact or cost?

– Can’t use QL on other pages – Lost functionality on calendars, wiki pages, blogs, meeting sites,

tree view, group work site, and managed metadata navigation • Are there any exceptions?

– Public facing SharePoint sites • What is the fix or workaround if I’ve already made the

mistake? – Add QL back into MP – Use page layouts to dictate hiding or showing

Page 39: 10 Worst Mistakes in SharePoint Branding
Page 40: 10 Worst Mistakes in SharePoint Branding
Page 41: 10 Worst Mistakes in SharePoint Branding

Not Considering the UI in Custom Development

What Is It? When developing a web part or ui component, you need to consider how it will be presented in the UI.

Joe Cool’s WebPart

• Simple Example • No way to select the items in the web part cleanly

using css

Page 42: 10 Worst Mistakes in SharePoint Branding

Johnny Smith’s code

All items are easily accessible via CSS Selectors

Page 43: 10 Worst Mistakes in SharePoint Branding

3rd Party Control Class on every level They are even nice enough to class the first and last items of sets

Page 44: 10 Worst Mistakes in SharePoint Branding

Summary:

Not Considering the UI in Custom Development

• What is this?

– When developing a web part or ui component, you need to consider how it will be presented in the UI.

• Why is this a mistake?

– Without “hooks” to manipulate the UI, hard to style • What is the impact or cost?

– Hard or impossible to brand – Development time

• Are there any exceptions?

– No. Bad practice. • What is the fix or workaround if I’ve already made the mistake?

– Specificity – Pseudo classes – Jquery (not recommended) – Change web parts if designed in house – Be considerate of the UI interface and put css classes on your web controls. If

you're unsure of what to class, then heres my rule; #1 Class Everything.

Page 45: 10 Worst Mistakes in SharePoint Branding

Modifying Default Files

What Is It? Going into the 14 hive in SharePoint and modifying default files

A Violation of the #1 Rule of SharePoint Branding Club

Graphic by Marcy Kellar

Page 46: 10 Worst Mistakes in SharePoint Branding

Summary:

Modify Default Files

• What is It?

– Making changes to default files on the SharePoint Server (14 hive) • Why is this a mistake?

– These files are the originals. You just don’t mess with the originals. – Changes may impact the entire farm. – Multiple WFE with load balancing mean changes need to be made in more than

one place. • What is the impact or cost?

– Difficult to troubleshoot – Cumulative Updates – Migration

• Are there any exceptions?

– No • What is the fix or workaround if I’ve already made the mistake?

– Replace anything that has been modified with a clean copy of the originals – Move your customizations out of the file and package into a feature

Page 47: 10 Worst Mistakes in SharePoint Branding

Summary:

The Top 10 Worst Mistakes in SharePoint Branding

1. Letting the Designer Get Carried Away

2. Applying Fixed Width to Collaboration Sites and System Pages

3. Using Too Many Master Pages

4. Breaking the Master Page During Development

5. Not Designing Around Real Content

6. Fixing the Width of the Ribbon

7. Using Content Editor Web Parts for Web Content

8. Removing the Left Nav Controls from Master Page

9. Not Considering the UI in Custom Development

10. Modifying Default Files

Page 48: 10 Worst Mistakes in SharePoint Branding
Page 49: 10 Worst Mistakes in SharePoint Branding

Panel Contact Information

Designer Marcy Kellar

@marcykellar

thesharepointmuse.com

Front End Developer Tom Daly

@_tomdaly_

thomasdaly.net

Developer Mike Mukalian

@mmukalian

www.mukalian.com/blog