Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.
About Me          !   President and CTO of Tribloom Inc.          !   Customizing Alfresco since 2008          !   Many we...
What are we talking about?          !     Background          !     Web Quick Start          !     Website          !     ...
BackgroundClient Seeking:          !   Document management          !   Website          !   IntranetLeading To:          ...
Document Management – High LevelGoals:          !   Replace existing shared drive infrastructure          !   Each departm...
Website- High LevelGoals:          !   Simple, professional, website for marketing and              information          !...
Intranet – High LevelGoals:          !     Display links to content from departmental sites          !     Display area fo...
Web Quick Start          !   Why Web Quick Start          !   How do you customize WQS (Surf)          !   How do you cust...
Why Web Quick Start?Speed          !   Quick implementation, about 5 weeks eachEase of Use          !   The end user can e...
How Do You Customize WQS? (Surf)          !   Sample finance and government sites are Spring Surf          !   Similar to ...
Surf Override File Structure12/6/11                © Tribloom, Inc. 2011   10
Surf Override File Structure (cont)12/6/11                © Tribloom, Inc. 2011   11
How Do You Customize WQS? (WQS API)WQS API          !   The WQS API is written in Java and uses Spring          !   Create...
How Do You Customize WQS? (WQS API)          !   Can build against WQS client API jar               !  /webapps/wcmqs/WEB-...
The Website          !   Platform          !   The good          !   The bad               !  Publishing          !   Cust...
The Platform          !     SUSE Linux 11.1          !     MySQL 5.5.8          !     Tomcat 6.0.29          !     Java 1....
WQS Implementation #1 – The Website          Old                               New12/6/11             © Tribloom, Inc. 201...
The WebsiteThe Best Of Times          !   OOTB Finance and Government sites easy to modify          !   Very little custom...
The WebsiteThe Worst Of Times          !   Download documents does not work OOTB (in IE)              (this has been fixed...
Single Server Publishing                            Supported OOTB                                      !   Transfer Servi...
Two Server PublishingNot Supported OOTB          !   Option 1: Replicate              Editorial to Delivery              a...
Website Customization Details          !   Theme               !  Duplicate existing theme and modify CSS and             ...
Surf Page          !   Surf page XML binds to a URI          !   Defines template instance          !   Defines components...
Surf Template and Template Instance          !   Defines template          !   Defines components          !   Defines reg...
Webscript          !   Descriptor          !   Controller12/6/11                    © Tribloom, Inc. 2011   24
Webscript (cont)          !   View12/6/11              © Tribloom, Inc. 2011   25
Website Customization Details (cont)          !   WQS Share site information schema               !  Create folders and co...
Website Customization Details (cont)          !   Image Gallery               !  WQS already uses LightBox, incorporated i...
The Intranet          !   The good          !   The bad          !   Customization details               !  Non WQS conten...
WQS Implementation #2 – The Intranet          Old                               New12/6/11             © Tribloom, Inc. 20...
The IntranetThe Best of Times          !   It is easy to use the WQS API to access properties of              content that...
The IntranetThe Worst of Times          !   The WQS API needed some changes in order to              usefully extend the c...
Intranet Customization Details          !   Biggest customization to display non-WQS content               !  Content mode...
Object Diagram                                                                 ws:article            fni:intranetContent  ...
Intranet Customization Details          !  Behaviors (Policies)             !  Automatically create content in WQS when as...
Intranet Customization Details (cont)             !  Custom components and webscripts to display             !  Search mod...
Conclusion          !   Building websites is quick and relatively painless              using WQS          !   Since WQS u...
Demo12/6/11   © Tribloom, Inc. 2011   37
Q&A12/6/11   © Tribloom, Inc. 2011   38
Upcoming SlideShare
Loading in …5
×

Web Quick Start with Tribloom: A tale of two wqs implementations

1,494 views

Published on

This session will cover various topics related to developing a production Web Quick Start (WQS) website along with how to customize WQS. We'll discuss a WQS website and WQS intranet implementation. We will dive into the details of each implementation and cover lessons learned.

Published in: Technology
  • Be the first to comment

Web Quick Start with Tribloom: A tale of two wqs implementations

  1. 1. About Me !   President and CTO of Tribloom Inc. !   Customizing Alfresco since 2008 !   Many website and customized Share implementations on Alfresco !   Would like to share my experiences with WQS !   Twitter: MMcCarthy01 !   Blog: www.tribloom.comblogsmichael12/6/11 © Tribloom, Inc. 2011 1
  2. 2. What are we talking about? !   Background !   Web Quick Start !   Website !   Intranet !   Demo !   Q&A12/6/11 © Tribloom, Inc. 2011 2
  3. 3. BackgroundClient Seeking: !   Document management !   Website !   IntranetLeading To: !   Increased process automation !   Reduced operating costsThe Answer? !   Alfresco12/6/11 © Tribloom, Inc. 2011 3
  4. 4. Document Management – High LevelGoals: !   Replace existing shared drive infrastructure !   Each department has its own folder on shared drive !   Some documents on shared drive are shared on company intranetImplementation: !   Use company AD server for SSO !   Create Share site templates for departmental sites !   Bulk load some content !   Custom versioning scheme !   UI customizations !   Content modeling12/6/11 !   Advanced Workflow © Tribloom, Inc. 2011 4
  5. 5. Website- High LevelGoals: !   Simple, professional, website for marketing and information !   Content for website should be managed outside of IT department !   Outside company produced website designImplementation: !   Create company theme in WQS !   Custom pages, templates, and components !   Incorporate Lightbox for “image gallery”12/6/11 © Tribloom, Inc. 2011 5
  6. 6. Intranet – High LevelGoals: !   Display links to content from departmental sites !   Display area for company links and applications !   Provide FAQ functionality !   Departments responsible for their own content !   Site search should find content in departmental sitesImplementation: !   Tie Share site content to Web Quick Start site using aspects, associations, and behaviors !   FAQs articles are tagged to allow sorting !   Modify search query to return all content12/6/11 © Tribloom, Inc. 2011 6
  7. 7. Web Quick Start !   Why Web Quick Start !   How do you customize WQS (Surf) !   How do you customize WQS (WQS API)12/6/11 © Tribloom, Inc. 2011 7
  8. 8. Why Web Quick Start?Speed !   Quick implementation, about 5 weeks eachEase of Use !   The end user can easily maintain existing content and add new content without any technical skillsEase of Implementation !   Easy integration with Alfresco repository !   WQS uses technologies we already know from Alfresco (CMIS, Surf, Webscripts)12/6/11 © Tribloom, Inc. 2011 8
  9. 9. How Do You Customize WQS? (Surf) !   Sample finance and government sites are Spring Surf !   Similar to Share, overwrite or add “web” assets such as JS, CSS, and images in webapps/wcmqs !  js !  css !  images !   Recommended method is to create directories under webapps/wcmqs/WEB-INF/classes/surf !  site/pages – for XML files !  site/templates – for XML files !  Templates – for Freemarker files !  Webscripts – for webscript files12/6/11 © Tribloom, Inc. 2011 9
  10. 10. Surf Override File Structure12/6/11 © Tribloom, Inc. 2011 10
  11. 11. Surf Override File Structure (cont)12/6/11 © Tribloom, Inc. 2011 11
  12. 12. How Do You Customize WQS? (WQS API)WQS API !   The WQS API is written in Java and uses Spring !   Create subclasses as necessary and load them using Spring !  Subclass: !  Spring bean:12/6/11 © Tribloom, Inc. 2011 12
  13. 13. How Do You Customize WQS? (WQS API) !   Can build against WQS client API jar !  /webapps/wcmqs/WEB-INF/lib/* !   May need to download the WQS source code and modify classes for extension !  Before: !  After:12/6/11 © Tribloom, Inc. 2011 13
  14. 14. The Website !   Platform !   The good !   The bad !  Publishing !   Customization details !  Theme !  Pages, Templates, & Components ! Webscripts !  Information schema !  Image gallery12/6/11 © Tribloom, Inc. 2011 14
  15. 15. The Platform !   SUSE Linux 11.1 !   MySQL 5.5.8 !   Tomcat 6.0.29 !   Java 1.6.0_24 !   Alfresco 3.4.2 initially, later Alfresco 3.4.3 !  There is a CMIS bug in 3.4.212/6/11 © Tribloom, Inc. 2011 15
  16. 16. WQS Implementation #1 – The Website Old New12/6/11 © Tribloom, Inc. 2011 16
  17. 17. The WebsiteThe Best Of Times !   OOTB Finance and Government sites easy to modify !   Very little customization !   Most work was creating theme from static designs12/6/11 © Tribloom, Inc. 2011 17
  18. 18. The WebsiteThe Worst Of Times !   Download documents does not work OOTB (in IE) (this has been fixed in later versions) !   Publishing from editorial to live is not cross server OOTB, only simple single server publishing is supported OOTB without customization12/6/11 © Tribloom, Inc. 2011 18
  19. 19. Single Server Publishing Supported OOTB !   Transfer Service used internally for Editorial to Live publishing12/6/11 © Tribloom, Inc. 2011 19
  20. 20. Two Server PublishingNot Supported OOTB !   Option 1: Replicate Editorial to Delivery and republish from Editorial to Live there !   Option 2: Publish on Editorial and transfer from Editorial to Delivery !  Use onEndInboundTransfer policy to hook into Editorial Editorial to Live transfer and begin transfer to Delivery Live12/6/11 © Tribloom, Inc. 2011 20
  21. 21. Website Customization Details !   Theme !  Duplicate existing theme and modify CSS and images /webapps/wcmqs/css/<theme>/* !  styles.css !  Some image files !  Create custom pages, templates, components and webscripts12/6/11 © Tribloom, Inc. 2011 21
  22. 22. Surf Page !   Surf page XML binds to a URI !   Defines template instance !   Defines components12/6/11 © Tribloom, Inc. 2011 22
  23. 23. Surf Template and Template Instance !   Defines template !   Defines components !   Defines regions12/6/11 © Tribloom, Inc. 2011 23
  24. 24. Webscript !   Descriptor !   Controller12/6/11 © Tribloom, Inc. 2011 24
  25. 25. Webscript (cont) !   View12/6/11 © Tribloom, Inc. 2011 25
  26. 26. Website Customization Details (cont) !   WQS Share site information schema !  Create folders and collections (i.e. for image collections on the side of each page)12/6/11 © Tribloom, Inc. 2011 26
  27. 27. Website Customization Details (cont) !   Image Gallery !  WQS already uses LightBox, incorporated it into site to allow image gallery functionality12/6/11 © Tribloom, Inc. 2011 27
  28. 28. The Intranet !   The good !   The bad !   Customization details !  Non WQS content !  Content model !  Object diagram !  Policies !  API extenstions !  Pages, Templates, & Components !  Searcy query !  Information Schema12/6/11 © Tribloom, Inc. 2011 28
  29. 29. WQS Implementation #2 – The Intranet Old New12/6/11 © Tribloom, Inc. 2011 29
  30. 30. The IntranetThe Best of Times !   It is easy to use the WQS API to access properties of content that are not directly exposed via the API !   It is easy to override the search query12/6/11 © Tribloom, Inc. 2011 30
  31. 31. The IntranetThe Worst of Times !   The WQS API needed some changes in order to usefully extend the core classes (this has been fixed in later versions) !   The Editorial to Live process does not work well with outside associations on WQS content, we needed to modify the process to re-create the association at the end of the transfer (this process is very similar to how you would create a two server publishing scheme)12/6/11 © Tribloom, Inc. 2011 31
  32. 32. Intranet Customization Details !   Biggest customization to display non-WQS content !  Content model changes !  New aspects (internal/external links) !  Custom WQS article subclass with association to Share site content12/6/11 © Tribloom, Inc. 2011 32
  33. 33. Object Diagram ws:article fni:intranetContent fni:article fni:site ws:image fni:intranetExternalLink fni:app12/6/11 © Tribloom, Inc. 2011 33
  34. 34. Intranet Customization Details !  Behaviors (Policies) !  Automatically create content in WQS when aspect added, move when renamed or moved (need to move not rename for QName path to be accurate) !  onAddAspect !  onMoveNode !  Automatically delete content from WQS when aspect removed or deleted !  onRemoveAspect !  beforeDeleteNode !  Extensions to WQS API to handle non-WQS content !  AssetFactoryWebscriptImpl !  AssetImpl12/6/11 © Tribloom, Inc. 2011 34
  35. 35. Intranet Customization Details (cont) !  Custom components and webscripts to display !  Search modifications (updated query to include associated non-WQS content) !  Duplicate org.alfresco.module.org_alfresco_module_wcmquickstar t.webscript.AssetSearch with corresponding descriptor !   Other customizations !  Custom components and webscripts for “Apps”, “Corporate Sites”, and FAQ !  Create folders and collections to easily maintain12/6/11 © Tribloom, Inc. 2011 35
  36. 36. Conclusion !   Building websites is quick and relatively painless using WQS !   Since WQS uses Surf for a front end OOTB, it is easy to learn and requires little coding to create a custom feeling website !   WQS provides easy management of website content for end users12/6/11 © Tribloom, Inc. 2011 36
  37. 37. Demo12/6/11 © Tribloom, Inc. 2011 37
  38. 38. Q&A12/6/11 © Tribloom, Inc. 2011 38

×