Liferay Portal 6 Enterprise Intranets Build and maintain impressive corporate intranets with Liferay Jonas X. Yuan BIRMINGHAM - MUMBAI Liferay Portal 6 Enterprise Intranets Copyright © 2010 Packt Publishing All rights reserved. No part of this book may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, without the prior written permission of the publisher, except in the case of brief quotations embedded in critical articles or reviews. Every effort has been made in the preparation of this book to ensure the accuracy of the information presented. However, the information contained in this book is sold without warranty, either express or implied. Neither the author, nor Packt Publishing, and its dealers and distributors will be held liable for any damages caused or alleged to be caused directly or indirectly by this book. Packt Publishing has endeavored to provide trademark information about all of the companies and products mentioned in this book by the appropriate use of capitals. However, Packt Publishing cannot guarantee the accuracy of this information. First published: April 2010 Production Reference: 1230410 Published by Packt Publishing Ltd. 32 Lincoln Road Olton Birmingham, B27 6PA, UK. ISBN 978-1-849510-38-7 www.packtpub.com Cover Image by Karl Swedberg (karl@englishrules.com) Credits Author Jonas X. Yuan Reviewer Amine Bousta Acquisition Editor Dilip Venkatesh Development Editor Mehul Shetty Technical Editors Aditya Belpathak Alfred John Charumathi Sankaran Copy Editors Leonard D'Silva Sanchari Mukherjee Indexers Hemangini Bari Rekha Nair Editorial Team Leader Aanchal Kumar Project Team Leader Lata Basantani Project Coordinator Shubhanjan Chatterjee Proofreaders Aaron Nash Lesley Harrison Graphics Geetanjali Sawant Nilesh Mohite Production Coordinators Avinish Kumar Aparna Bhagat Nilesh Mohite Cover Work Aparna Bhagat About the Author Dr. Jonas X. Yuan is a Senior Technical Analyst at CIGNEX. He holds a Ph. D. in Computer Science from the University of Zurich, specializing in Integrity Control in Federated Database Systems. He earned his M.S. and B.S. degrees from China, where he conducted research on expert systems for predicting landslides. Jonas is experienced in Systems Development Life Cycle (SDLC). Previously, he worked as a Project Manager and a Technical Architect in Web GIS (Geographic Information System). He has hands-on skills in J2EE technologies. Most importantly, he has developed a BPEL (Business Process Execution Language) Engine called BPELPower from scratch in the NASA data center. He has a lot of experience with content management and publishing such as Media/Games/Publishing. He is also an expert on Liferay Portal, Content Management Systems (CMS) Alfresco, Ad Server OpenX, BPM Intalio, Business Intelligence Pentaho, LDAP, and SSO. Acknowledgement I would like to thank all my team members at Liferay, specially Raymond Auge, Brian Chan, Bryan Cheung, Jorge Ferrer, Michael Young, Jerry Niu, Ed Shin, Craig Kaneko, Brian Kim, Bruno Farache, Thiago Moreira, Amos Fong, Scott Lee, David Truong, Alexander Chow, Mika Koivisto, Julio Camarero, Douglas Wong, Ryan Park, Eric Min, John Langkusch, Marco Abamonga, Ryan Park, Eric Min, John Langkusch, Marco Abamonga, Michael Han, Samuel Kong, Nate Cavanaugh, Arcko Duan, Richard Sezov, Joshua Asbury, Shuyang Zhou of Liferay for providing all the support and valuable information. A special thanks to all my team members at CIGNEX for making this book a reality. I would like to thank Paul Anthony, Munwar Shariff, and Rajesh Devidasani for their encouragement and great support; our sales and presales team, Amit Babaria, Harish Ramachandran, helped me understand what customers are looking at. Our consulting team Robert Chen, Mike Walker, Venkata Challagulla, Michael Venford and Frank Yu presented me the various avors of Liferay implementations with real- life examples. I am thankful to them. I sincerely thank and appreciate Dilip Venkatesh and Mehul Shetty, Senior Acquisition Editor and Development Editor respectively at Packt Publishing for criticizing and xing my writing style. Thanks to Aditya Belpathak, Alfred John, Charumathi Sankaran, Shubhanjan Chatterjee and entire team at Packt Publishing; it is really joyful to work with them. Last but not least, I would like to thank my parents and my wife, Linda, for their love, understanding and encouragement. My special thanks to my wonderful and understanding kid Joshua. About the Reviewer Amine Bousta is a French Senior Technical Analyst in Groupe Open. He holds a French diploma of Computer Engineering (equivalent to master's degree) and a Technology Research Diploma in Articial Intelligence (neural networks applied to e-commerce). Specialized in JEE, he monitors and studies most of the related technologies and open source products in order to apply them as solutions for various companies' needs. From 2007, his technology watch on open source Java Portal Engines led to Liferay Portal as the most exible and complete free portlets engine. The Liferay Community Site gave him the opportunity to meet Dr Jonas X. Yuan and read his previous publications, then become the technical reviewer of this book. I would like to warmly thank my family, my dear co-workers, and my friends for not spamming me with their usual pointless technical questions while I was reviewing this book! So my special thanks to the following List of Nominees in Java Harassment Category: Julien Nicolet, Laurent Witt, Jacques Scius, Nicolas Burg, Olivier Spieser, Angelo Zerr, Olivier Dub, Diana Garzon, Hadrien Beauls, Mohamadou Kane, and Mohamed Cherroud. And in the Microsoft-Software-Time-Wasting-Questions Category: my beloved mom and sister. ;-) Table of Contents Preface 1 Chapter 1: Introducing Liferay for your Intranet 9 What are we going to build? 9 Hosted discussions 9 Collaborative documents using wikis 10 Team and individual blogs 10 Shared calendars 11 Document stores—CMS 11 Web Content Management—WCM 11 Personalization and internalization 12 Workow, staging, scheduling, and publishing 12 Social network and Social Ofce 13 And more 13 Everything in one place 13 Introducing Palm Tree Publications 14 Liferay portal framework 16 Service Oriented Architecture 16 Enterprise Service Bus 17 Why use Liferay to build an intranet? 18 It has got the features we need 18 It's easy to set up and use 18 It's free and open source 18 It will grow with you 19 It works with other tools 19 It is based on "standards" 20 What else can Liferay do? 21 Corporate extranets 21 Collaborative websites 21 Table of Contents [ ii ] Content management and web publishing 21 Infrastructure portals 22 Finding more information 22 Summary 23 Chapter 2: Setting Up a Home Page and Navigation Structure for the Intranet 25 Experiencing the portal 26 Getting portal pages 26 What's happening? 28 Experiencing portlets 28 Using the portlet container 29 How does the portal work? 29 Working of portlets 30 Portlet lifecycle 31 Terminologies, scope, and hierarchy 32 Setting up the portal 33 Using the Liferay portal bundled with JBoss 5.x in Windows 34 Using Liferay portal bundled with Tomcat 6.x in Linux 35 Clean and restart 36 Setting up production servers 36 Setting up domains 37 Shortening the URL 37 More options for portal installation 38 Flexible deployment matrix 38 Building pages 39 Adding pages 40 Removing pages 41 Adding portlets 42 Removing portlets 42 Changing layout templates 43 Setting up portal pages 44 Managing pages 44 Adding a child page 45 Changing the display order 46 Editing a page 46 Multiple languages 46 Friendly URL 47 Page icon 47 Copying pages 47 Deleting a page 48 Changing the look and feel: themes 48 Customizing portlets 49 Portlet Look and Feel 50 Table of Contents [ iii ] Setting up portlet conguration 51 Navigating the structure of an intranet site 52 Conguring portal 53 Conguring portal paths 54 Customizing portal conguration 55 Adding extended properties les 55 Portal structure 56 Portal context 57 Terms of Use 58 Reminder queries 59 Session settings 60 Layout types 62 Default user public layouts and private layouts 63 Default admin 65 Guest layouts 65 Friendly URL 66 Look and Feel 66 Dock bar menu 68 What's happening? 68 Dock bar menu in themes 70 My Places 70 Database connections 71 JNDI name 72 Properties 72 Populating with default data 73 Transaction isolation 74 Custom SQL 74 Mail conguration 75 Mail session 75 Java-mail 77 Mail hook 78 Bring pages together in action 79 Page Comments 79 Page Ratings 80 Page Templates 81 Page Flags 82 How do you share portlets within a portal page? 83 Conguring Control Panel 84 Administration 85 My Account 85 My Pages 86 Conguration and settings 87 Adding custom portlets 88 What's happening? 89 Summary 89 Table of Contents [ iv ] Chapter 3: Bringing in Users 91 Enterprise, departments, and locations 92 Role-based access control 93 Role and permission 94 User 94 Organization and Location 94 UserGroup and Community 95 Organizations 95 Adding a top-level Organization 95 Managing organizations 97 Adding child organizations 97 Viewing organizations 98 Searching organizations 98 Editing an organization 99 Deleting an organization 100 Assigning users to an organization 101 Using organizations in an effective way 102 Locations 102 Adding a location for the enterprise 102 Adding locations for main organizations 103 Viewing locations 104 Searching locations 104 Editing a location 105 Deleting a location 105 Assigning users to a location 106 Using locations in an effective way 106 Organization settings 107 Organization types 107 Organization forms 108 Overriding assignment and membership 109 Hierarchy, tree, and Shared Global 109 Organization hierarchy 110 Organization tree 110 Shared Global 110 User groups 111 Adding a user group 111 Managing user groups 112 Viewing user groups 112 Searching user groups 113 Editing a user group 113 Deleting user groups 113 Assigning users to a user group 113 Users 114 Adding users 114 What's happening? 116 Adding more users 116 [...]... configuration 16 3 16 3 16 4 16 4 16 5 16 5 16 5 16 5 16 6 16 6 16 7 16 8 17 1 17 2 17 2 17 3 17 3 17 5 17 5 17 7 The permissions on Message Boards portlet Permissions on Message Boards content Permissions on category Permissions on message Category hierarchy 17 8 18 0 18 1 18 3 18 5 [ vi ] Table of Contents Semantics and Ontology 18 5 Categorization Tagging assets 18 5 1 86 Folksonomies Taxonomies 1 86 18 7 Tags administration 18 8 Assigning... does it work? What's happening? 61 3 61 3 Clustering - high availability HTTP services 61 3 61 5 Configuring mod_jk Configuring Tomcat Configuring JBoss Configuring portal Database replication and clustering Repository clustering UrlRewrite filter Configuration 61 5 61 7 61 7 61 8 61 8 61 9 62 1 62 1 Cloud Computing Data backup and migration Data backup Data migration 62 2 62 3 62 4 62 4 Performance tuning Integrating... Permission algorithms 15 1 What's happening? Data migration 15 2 15 3 Summary Chapter 4: Forums, Categorization, and Asset Publishing Message Boards Managing categories Adding categories Editing categories Deleting categories 15 4 15 5 1 56 1 56 1 56 15 8 15 9 Managing threads 15 9 Managing posts 16 2 Subscribing categories and threads 16 6 Customizing Message Boards Setup 16 8 16 8 Assigning permissions 17 8 Using Message... configuration 1 26 1 26 LDAP authentication 12 9 SSO authentication 13 3 What's happening? Basic authentication Auto login 12 7 12 8 12 8 What's happening? Using LDAP effectively LDAP authentication chain CAPTCHA 13 0 13 1 13 2 13 2 What's happening? OpenID authentication NTLM authentication Open SSO authentication SiteMinder authentication Authentication token 13 4 1 36 1 36 13 7 13 8 13 9 Roles Adding a role 14 0 14 0 What's... Auto Deploy What's happening? 559 560 560 5 61 What's happening? 563 WAP Jedi Mobile theme 563 564 Structure How does it work? What's happening? 564 564 564 iPhone theme 565 iPhone Redirect theme 566 Reporting JasperReports Engine The Reports portlets 567 567 567 How does it work? What's happening? 565 565 How does it work? What's happening? 566 566 Setup Structure 569 570 [ xvii ] Table of Contents... Adding users in bulk 11 7 Managing users 11 8 User settings 12 4 Creating an account on the fly What to do when a user forgets the password? Viewing users Searching for users Editing a user profile Deactivating a user Activating a user Deleting a user Impersonating a user Using the Actions tab 11 7 11 8 11 9 11 9 12 0 12 2 12 3 12 3 12 4 12 4 User forms Overriding user-related properties 12 5 12 5 Authentications... it work? What's happening? Service model 508 510 511 511 512 [ xv ] Table of Contents Enhancement 512 Hooks Setup What's happening? 512 513 515 Custom Fields Managing custom fields 518 518 Assigning permissions 522 What's happening? 524 Portal Properties Hooks Language Properties Hooks Custom JSP Hooks Portal Service Hooks Enhancement 515 515 5 16 517 517 Adding custom fields Viewing custom fields Adding/updating... happening? 592 593 594 595 5 96 597 [ xviii ] Table of Contents Database sharding 597 Portal administration Password policies 60 0 60 1 Setup What's happening? 598 599 Assigning permissions What's happening? 60 2 60 3 Portal settings 60 4 Monitoring live users' activities 61 2 General information Users Email notifications Display settings How does it work? What's happening? 60 5 60 6 60 6 60 7 60 7 60 8 How does it work?... happening? 14 1 Managing roles 14 1 Viewing roles Searching roles Editing a role Deleting roles Assigning members Using roles in an effective way What's happening? 14 1 14 2 14 2 14 2 14 2 14 3 14 4 Authorization Permission Permissions in scope 14 5 14 5 14 7 Assigning portal- level permissions 14 8 [v] Table of Contents Assigning individual portlet permissions Using permissions in an effective way 15 0 15 0 Permission... LDAP and SSO CAS 62 6 Database migration Repository migration What's happening? How does it work? 62 5 62 5 62 6 62 9 63 0 63 3 Alfresco web client as a set of portlets 63 3 Full Integration Liferay, Alfresco, LDAP, and SSO CAS 63 5 How does it work? How does it work? What's happening? [ xix ] 63 4 63 6 63 7 Table of Contents Integrating with Ad server OpenX OpenX integration Ad Manager 63 9 63 9 64 0 How does it . posts 16 3 Editing posts 16 3 Banning users 16 4 Deleting posts 16 4 Viewing posts 16 5 Searching posts 16 5 Viewing My Posts 16 5 Viewing Recent Posts 16 5 Viewing Statistics 16 6 Viewing Banned Users 16 6 Subscribing. group 11 1 Managing user groups 11 2 Viewing user groups 11 2 Searching user groups 11 3 Editing a user group 11 3 Deleting user groups 11 3 Assigning users to a user group 11 3 Users 11 4 Adding users 11 4 What's. Boards 1 56 Managing categories 1 56 Adding categories 1 56 Editing categories 15 8 Deleting categories 15 9 Managing threads 15 9 Add threads 16 0 Edit threads 16 1 Delete threads 16 2 Managing posts 16 2 Adding