Liferay

EnterpriseAdmin-portlet

2009-07-21T16:06:00.001+05:30

3 types of users
1.user
2.power user
3.Admin user

=========================================================================================
1.Creating Users
=========================================================================================

1.1 Log in to your Portal as the administrative user , test@liferay.com

1.2 Use the Dock to navigate to the Add Application

1.3 Add Enterprise Admin Portlet and Click on Users tab

1.4 Click Add User

1.5 Enter data to Screen name= writer , Email=writer@liferay.com, First Name =writer etc

1.6 Click Save

1.7 Add 2 more users with Screen Name= approver and publisher (This is for Workflow)

1.8 Click the Password tab and enter a new password for the users created

1.9 Click Save.

1.10.Navigate to Different User Information you can update and Save

1.11 In the USERS view tab Edit,Permissions, Manage Pages,Impersonate User and Deactivate Actions are there
Please Navigate it and check.

=========================================================================================
2.Creating Organizations
=========================================================================================

1.1 Log in to your Portal as the administrative user , test@liferay.com

1.2 Use the Dock to navigate to the Add Application

1.3 Add Enterprise Admin Portlet and Click on Organizations tab

1.4 Click Add Organization

1.5 Enter Name= skali , Type Regular Organization ,Country=Malaysia

1.6 Click Save

1.5 Enter Name= Marketing , Type Regular Organization ,Country=Malaysia Select Parent Organization=skali

1.7 Once Organiztions are created in tab the Organization lists will be displayed and Navigate to Different Actions by clicking Actions tab

1.8 assign members to the organizations thru
=========================================================================================
3.Create/Assign UserGroups
=========================================================================================
1.1 Log in to your Portal as the administrative user , test@liferay.com

1.2 Use the Dock to navigate to the Add Application

1.3 Add Enterprise Admin Portlet and Click on UserGroups tab

1.4 Click Add

1.5 Enter Name= usergroup

1.6 Click Save

1.7 Navigate to Different Actions by clicking Actions tab

1.8 assign members to the user group and manage pages to have common as the user groups

=========================================================================================
4.Create/Assign Roles
=========================================================================================
1.1 Log in to your Portal as the administrative user , test@liferay.com

1.2 Use the Dock to navigate to the Add Application

1.3 Click Roles

1.4 Click Add

1.5 Enter Name= writer

1.6 Click Save

1.7 Navigate to Different Actions by clicking Actions tab

1.8 assign members to the roles in actions tab

Community
=========================================================================================
5.Creating Communities
=========================================================================================
1.1 Log in to your Portal as the administrative user , test@liferay.com

1.2 Use the Dock to navigate to the Add Application

1.3 Add Communities Portlet

1.4 Click Add Community

1.5 Enter Name= Developer , Type =Open

1.6 Click Save

1.7 Navigate to Different Actions by clicking Actions tab

1.8 assign members to the communities in actions tab

Exercise
Create a community in one instance

Create some public and private pages for the created community add some portlets

Create another community in another instance

Export the LAR file and import the LAR file into another instance

Creating a new Theme

2009-07-21T09:55:00.002+05:30

In the $PLUGINS_SDK/themes folder run:

ant -Dtheme.name=newtheme -Dtheme.display.name="My New Theme" create

"newtheme" will be the theme name we would like to give.

"My New Theme" will the display name of our theme.

Navigate to the newly created $PLUGINS_SDK/themes/newtheme/_diffs and add some customizations to the default theme.

After this, In the $PLUGINS_SDK/themes folder run:

ant war

The war file of our theme will be created in the $PLUGINS_SDK/themes/dist .

Now deploy this war file.

You can go to your deploy (webapps) directory and see the new theme folder being created there.

Once your theme has been deployed, and you're ready to modify the CSS, use the custom.css file to change and override the default styling, leaving all of the other CSS files alone. You can modify any of the javascript files, image files, and template files, but the CSS changes should be restricted to custom.css.

Once you're done modifying your files, you must place them in your _diffs directory with the same directory structure as the actual theme.we'll assume that you've modified the custom.css file, an image file in the dock, and two template

files: portal_normal.vm and portlet.vm. With those files, your _diffs directory would look like this:

plugins/themes/newtheme/

_diffs/

css/

custom.css

images/

dock/

menu_bar.png

templates/

portal_normal.vm

portlet.vm

The order in which your theme is built goes something like this:

It creates the directory and adds the appropriate build files, and XML files needed. It then copies all of the files from the _unstyled/ directory, and after that, the files from _styled/ are copied over, and the last step is that your files in the _diffs directory are copied over. So this means you will place all of your new files and changed files into the _diffs directory.

Color Schemes

In your liferay-look-and-feel.xml (located in WEB-INF), you would specify the class names like so:

<theme id="my_theme" name="My Theme">

<root-path>/my_theme</root-path>

<templates-path>${root-path}/templates</templates-path>

<images-path>${root-path}/images</images-path>

<template-extension>vm</template-extension>

<color-scheme id="01" name="Blue">

<css-class>blue</css-class>

<color-scheme-images-path>${images-path}/color_schemes/${css-class}</color-scheme-images-path>

</color-scheme>

<color-scheme id="02" name="Green">

<css-class>green</css-class>

</color-scheme>

</theme>

The way you would style your different color schemes is like so:

Inside of your css directory, create a folder called "color_schemes". Inside of that directory, place a css file for each of your color schemes. In the case above, we would could either have just one called green.css and let the default styling handle the first color scheme, or you could have both blue.css and green.css.

Now, inside of your custom.css, you would place the following lines:

@import url(color_schemes/blue.css);

@import url(color_schemes/green.css);

The way you would identify the styling for the css is this way: In blue.css you would prefix all of your css styles like this:

.blue a {color: #06C;}

.blue h1 {border-bottom: 1px solid #06C}

And in green.css you would prefix all of your css styles like this:

.green a {color: #0C6;}

.green h1 {border-bottom: 1px solid #0C6}

Customization of CSS

Here are the descriptions for each of the CSS files:

main.css

this file includes all of the other css files. This file can be edited, but probably should not be.

custom.css

This file is where the developer should place all of their css that is different from the other files, unless they are not concerned about upgrading their theme later on. By placing their custom CSS in this file, and not touching the other files, they can be assured that the upgrading of their theme later on will be much smoother.

base.css

This file contains all of the base styling that is fairly generic, such as the styling for all elements not directly related to another aspect of the site, such as the forms or navigation or dock.

forms.css

This file contains all css styling related to form elements on the page.

layout.css

This file contains all of the styling related to the layouts. It is fairly low level, and should most likely not be edited, unless there is something specific they need.

navigation.css

This file contains all of the styling related to the navigation, as well as the dock.

portlet.css

This file contains all of the styling related to the portlets, including the JSR-168 class-names.

tabs.css

This file includes all of the styling related to the tabs in the portlets.

deprecated.css

This file contains styles that are deprecated, but included for compatibility. It can most likely be safely ignored.

Use the custom.css file to change and override the default styling, leaving all of the other CSS files alone. You can modify any of the javascript files, image files, and template files, but the CSS changes should be restricted to custom.css.

For example the body background color is defined in base.css as follows:

body {

background-color: #fff;

}

in the above example the background color used is white ,and if would like to change the color to say black then write the below css in custom.css:

body {

background-color: #000;

}

Similarly we can change the default css by rewriting them in custom.css

Templates:

Here are the descriptions for each of the templates:

portal_normal.vm

this file contains the overall site structure, from opening HTML tag to closing. It includes the header, and footer, and includes the two templates (i.e., dock.vm and navigation.vm) and it also includes the system files needed by the liferay core

dock.vm

this file contains all of the HTML for the dock.

navigation.vm

this file contains all of the html for the navigation

portal_pop_up.vm

this file contains the entire html structure for popup windows.

portlet.vm

this file contains the HTML that wraps every portlet, including the portlet title and portlet-icons.

Customization of templates:

Example portal_normal.vm

If we want the dock to appear only when the user is signed in then the following changes have to be made in portal_normal.vm

Replace the following code

#parse ("$full_templates_path/dock.vm")

with

#if ($themeDisplay.isSignedIn())

#parse ("$full_templates_path/dock.vm")

#end

Spring Portlet

2009-07-21T09:17:00.001+05:30

Step 1:

create a dummy JSP portlet to begin with by using the following command

create.bat weather "Weather Spring Portlet"

================================================================

Step 2:

create a folder "context" under "/docroot/WEB-INF"

create file "weather-portlet.xml" under "context"

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "../../dtd/spring-beans.dtd">

<beans>

<bean id="weatherService" class="com.sample.weather.WeatherServiceImpl" />

<bean id="weatherController" class="com.sample.weather.WeatherController">

<property name="weatherService" ref="weatherService" />

</bean>

<bean class="org.springframework.web.portlet.handler.PortletModeHandlerMapping">

<property name="portletModeMap">

<map>

<entry key="view" value-ref="weatherController" />

</map>

</property>

</bean>

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">

<property name="viewClass" value="org.springframework.web.servlet.view.JstlView" />

<property name="prefix" value="/jsp/" />

<property name="suffix" value=".jsp" />

</bean>

</beans>

================================================================

Step 3:

create file "application.xml" under "context"

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "../dtd/spring-beans.dtd">

<beans>

<bean id="weatherService" class="com.sample.weather.WeatherServiceImpl" />



<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">

<property name="cache" value="false"/>

<property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>

<property name="prefix" value="/jsp/"/>

<property name="suffix" value=".jsp"/>

</bean>

</beans>

================================================================

Step 4:

create file "view.jsp" docroot/jsp

<%@ page contentType="text/html" isELIgnored="false" %>

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>

<table border="1">

<tr>

<th>City</th>

<th>Temperature</th>

</tr>

<c:forEach items="${temperatures}" var="temperature">

<tr>

<td>${temperature.key}</td>

<td>${temperature.value} </td>

</tr>

</c:forEach>

</table>

================================================================

Step 5:

create file WeatherController.java under /docroot/WEB-INF/src/com/sample/weather

package com.sample.weather;

import javax.portlet.RenderRequest;

import javax.portlet.RenderResponse;

import org.springframework.web.portlet.ModelAndView;

import org.springframework.web.portlet.mvc.AbstractController;

public class WeatherController extends AbstractController {

private WeatherService weatherService;

public void setWeatherService(WeatherService weatherService) {

this.weatherService = weatherService;

}

public ModelAndView handleRenderRequestInternal(

RenderRequest request, RenderResponse response) throws Exception {

return new ModelAndView("view","temperatures", weatherService.getMajorCityTemperatures());

}

}

================================================================

Step 6:

create the interface WeatherService.java under /docroot/WEB-INF/src/com/sample/weather

package com.sample.weather;

import java.util.Map;

public interface WeatherService {

public Map<String, String> getMajorCityTemperatures();

}

================================================================

Step 7:

create the implementation WeatherServiceImpl.java under /docroot/WEB-INF/src/com/sample/weather

package com.sample.weather;

import java.util.HashMap;

import java.util.Map;

public class WeatherServiceImpl implements WeatherService {

public Map<String, String > getMajorCityTemperatures() {

Map<String, String > temperatures = new HashMap<String, String>();

temperatures.put("New York", "6.0");

temperatures.put("London", "10.0");

temperatures.put("Singapore", "5.0");

return temperatures;

}

}

Step 8:

Modify portlet.xml file

replace,

<portlet-class>com.sample.jsp.portlet.JSPPortlet</portlet-class>

with,

<portlet-class>org.springframework.web.portlet.DispatcherPortlet</portlet-class>

-------------------------

replace,

<init-param>

<name>view-jsp</name>

<value>/view.jsp</value>

</init-param>

with,

<init-param>

<name>contextConfigLocation</name>

<value>/WEB-INF/context/weather-portlet.xml</value>

</init-param>

----------------------------

insert

<portlet-mode>view</portlet-mode>

<portlet-mode>help</portlet-mode>

inside,

<supports> elements

================================================================

Step 8:

(insert the below contents into web.xml)

<display-name>Weather Portlet based on Spring</display-name>

<context-param>

<param-name>webAppRootKey</param-name>

<param-value>com.sample.weather</param-value>

</context-param>

<context-param>

<param-name>log4jConfigLocation</param-name>

<param-value>/WEB-INF/classes/log4j.properties</param-value>

</context-param>

<context-param>

<param-name>contextConfigLocation</param-name>

<param-value>/WEB-INF/context/application.xml</param-value>

</context-param>

<listener>

<listener-class>org.springframework.web.util.WebAppRootListener</listener-class>

</listener>

<listener>

<listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>

</listener>

<listener>

<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>

</listener>

<servlet>

<servlet-name>ViewRendererServlet</servlet-name>

<servlet-class>org.springframework.web.servlet.ViewRendererServlet</servlet-class>

<load-on-startup>1</load-on-startup>

</servlet>

<servlet-mapping>

<servlet-name>ViewRendererServlet</servlet-name>

<url-pattern>/WEB-INF/servlet/view</url-pattern>

</servlet-mapping>

================================================================

Step 9:

Copy the contents of "lib" folder to "WEB-INF/lib"

Email Validation

2009-07-20T18:06:00.002+05:30

Simple Struts Portlet

2009-07-20T18:01:00.001+05:30

1) portlet-ext.xml

--------------------

<portlet>

<portlet-name>EXT_3</portlet-name>

<display-name>Library Portlet</display-name>

<portlet-class>com.liferay.portlet.StrutsPortlet</portlet-class>

<init-param>

<name>view-action</name>

<value>/ext/library/view</value>

</init-param>

<expiration-cache>0</expiration-cache>

<supports>

<mime-type>text/html</mime-type>

</supports>

<resource-bundle>com.liferay.portlet.StrutsResourceBundle</resource-bundle>

<security-role-ref>

<role-name>power-user</role-name>

</security-role-ref>

<security-role-ref>

<role-name>user</role-name>

</security-role-ref>

</portlet>

2) liferay-portlet-ext.xml

----------------------------

<portlet>

<portlet-name>EXT_3</portlet-name>

<struts-path>ext/library</struts-path>

<use-default-template>false</use-default-template>

</portlet>

3) liferay-display.xml

------------------------

add

<portlet id="EXT_3" />

inside

<category name="category.example">

4) struts-config.xml

----------------------

<action path="/ext/library/view" forward="portlet.ext.library.view" />

5) tiles-defs.xml

-------------------

<definition name="portlet.ext.library" extends="portlet" />

<definition name="portlet.ext.library.view" extends="portlet.ext.library">

<put name="portlet_content" value="/portlet/ext/library/view.jsp" />

</definition>

(create the following two jsp files under "/ext/ext-web/docroot/html/portlet/ext/library")

6. init.jsp

-------------

<%@ include file="/html/portlet/init.jsp" %>

Add commonly used variables and declarations here!

7. view.jsp

-------------

<%@ include file="/html/portlet/ext/library/init.jsp" %>

Simple Struts Portlet!

8 Language-ext.properties

---------------------------

Add a new entry in the above file,

javax.portlet.title.EXT_3=Library Portlet

Basic JSP Portlet

2009-07-20T17:11:00.001+05:30

1.Basic JSP Portlet

~~~~~~~~~~~~~~~~~~~

[the xml files are located under "ext/ext-web/docroot/WEB-INF"]

1.1. portlet-ext.xml

--------------------

(insert the below content)

<portlet>

<portlet-name>EXT_2</portlet-name>

<display-name>JSP Portlet Introduction</display-name>

<portlet-class>com.liferay.util.bridges.jsp.JSPPortlet</portlet-class>

<init-param>

<name>view-jsp</name>

<value>/html/portlet/ext/jsp_portlet/view.jsp </value>

</init-param>

<expiration-cache>0</expiration-cache>

<supports>

<mime-type>text/html</mime-type>

</supports>

<resource-bundle>com.liferay.portlet.StrutsResourceBundle</resource-bundle>

<security-role-ref>

<role-name>power-user </role-name>

</security-role-ref>

<security-role-ref>

<role-name>user</role-name>

</security-role-ref>

</portlet>

1.2. liferay-portlet-ext.xml

----------------------------

(insert the below content)

<portlet>

<portlet-name>EXT_2</portlet-name>

</portlet>

1.3. liferay-display.xml

------------------------

(insert the below content)

<category name="category.example">

<portlet id="EXT_2">

</category>

1.4. view.jsp

-------------

(create this file under "ext/ext-web/docroot/html/portlet/ext/jsp_portlet"

and enter the below contents)

Welcome to simple Basic JSP Portlet

Note: after this step do "ant deploy" from "ext-web"

1.5 Language-ext.properties

---------------------------

(under /ext/ext-impl/src/content)

Add two new entries in the above file,

javax.portlet.title.EXT_2=JSP Portlet

category.example=Example

Note: after this step do "ant deploy" from "ext-impl"

Writing Dynamic Query using Hibernate API's

2009-07-20T17:08:00.001+05:30

1:
=======
in AddBookAction.java:

if (Validator.isNull(cmd)) {
BookLocalServiceUtil.create(bookTitle);
} else {
List results = null;
if (cmd.equals("find")) {
results = BookLocalServiceUtil.findBooks(bookTitle);
} else {
DetachedCriteria dCriteria = DetachedCriteria.forClass(Book.class);
dCriteria.add(Restrictions.like("title", "%" + bookTitle + "%"));
DynamicQuery dynamicQuery = new DynamicQueryImpl(dCriteria);
results = (List)BookLocalServiceUtil.dynamicQuery(dynamicQuery);
}
req.setAttribute("results", results);
req.setAttribute("cmd", cmd);
}
2:
=======
in view.jsp

Add for 'search' button

findBook('search');" />

Note: the findBook JS function is now accepting a parameter, do changes to this function and also to the "Find Book" button.
3:
=======

in Success.jsp update this

if (Validator.isNotNull(cmd)) {
books = (List)request.getAttribute("results");
} else {
books = BookLocalServiceUtil.getAllBooks();
}
4 :
========
ant deploy from ext-impl,
ant deploy from ext-web,
restart tomcat

Websites Developed by Liferay

2009-07-20T17:03:00.000+05:30