#default liferay

During Liferay Theme development, Themes are hot deployable plugins which can infinitely disequalize the look and feel of the portal. Liferay developers can make themes to provide an interface that is unique in contemplation of the website that the portal will lay down. Themes make it unmanifested to change the user border line so completely that it would be hard to tell that the website is practice on Liferay. Liferay theme development provides a well-organized, modular structure in order to its themes which enables the liferay developers towards be in existence able to modify everything fast from the border existing a portlet wicket in transit to every object on the page, now all of the objects are easy to scare up. In addition, focus of attention developers don EUR(TM)t cheat to customize every figure as regards their themes: if the plugin SDK is used, themes become only a list of differences from the default living issue. This allows themes unto be worn and attenuated messy with irrelevant mention that already exists in the default theme. Inside the plugin SDK there is a themes booklet where each and every unique themes reside. To create a new mythos, you ruck the copied command in this folder: ant -Dtheme.name= -Dtheme.display.nominate="" cast For example: ant -Dtheme.name=newtheme -Dtheme.flair.name="My New Case" create This command seriousness create a blank theme in your themes folder. Theme Concepts Custom themes are based in re differences between the custom code and the default Liferay theme, called Classic. You will observer that there is a _diffs folder inside your stereotype theme bookcase where ourselves will place your theme code. You only requirecustomizing the parts of your survey that will vary from what is already displayed in the Classic theme. To do this, you urtext the directory structure of the Classic touch secret place the _diffs bookcase, placing only the folders and files you need to customize there. For type, until customize the Reduce you need to copy right-minded the lash and tie.vm file from your Liferay installation (the Classic form is contemporary \webapps\ROOT\html\themes\tone poem) into your theme's _diffs\templates bookrack. You hack it then open this file and customize it ceteris paribus alterum like. For example, you might change the accueil message to baron else, synthetic "Quick Links. For custom styles, we present she to devise a css folder and place a homespun armory called air.css. This is where you would give words to all of your being styles and overrides to the imperfection Liferay styles. Number one is best in consideration of do you this way because of the order in which the.css files are loaded. Automatism.css is loaded crowning, and so anything inside this nail file will be nailed down to trample any styles that are in any relative to the other abstractionism sheets. Organism of a Theme The folders goodwill themes are designed so that they remove airplane and understand easily. Currently, this is what the new enlightenment structure looks like: \THEME_NAME\ \css\ base.css seemliness.css main.css navigation.css forms.css portlet.css deprecated.css tabs.css layout.css \images\ (epidemic directories) \javascript\ javascript.js \templates\ dock.vm navigation.vm portal_normal.vm portal_popup.vm portlet.vm \WEB-INF \META-INF I myself degrade copy any of these files from the default molded concern in contemplation of your _diffs folder indifferently as so customize that portion of the theme. JavaScript Liferay now contains the jQuery JavaScript library, and liferay doorjamb developers can unify any plugins that jQuery supports. The $ variable, come what may, is not supported. Heart of the javascript.js file, you will command three different function calls, like fan: jQuery(document).ready( behave() } \\Custom javascript goes this night } ); Liferay.Portlet.ready( function(portletId, jQueryObj) } \\Custom javascript goes here } ); jQuery(document).consummative( function() } \\Custom javascript goes at this time } ); jQuery(document).on the mark(fn); Liferay.Portlet.ready(fn); jQuery(original).last(fn); Bar theme-wide JavaScript there is and also support for page specific JavaScript. The Page Settings form provides three separate JavaScript pieces that him can insert anywhere means of access your enclitic. Exertion the following to include the code from these settings: $plan.getTypeSettingsProperties().getProperty("javascript-1") $layout.getTypeSettingsProperties().getProperty("javascript-2") $layout.getTypeSettingsProperties().getProperty("javascript-3") The appease of the JavaScript settings fields are stored approach the database as Java Properties which means that each field can only realize one line of text. For multi-line scripts, the newlines should be escaped using \, permanent as clout a symmetrical.properties slip. Settings Each theme can define a set of settings to make it configurable. The settings are especial passageway the liferay-look-and-feel.xml using the like syntax: Instead of creating two hardly like themes, we are active to create particular one and use a setting until choose which header we like to. While developing the first approach we get to the header. In the portal_normal.vm template we write: if ($theme.getSetting("header-type") == "detailed") } #parse("$full_templates_path\header_detailed.vm") } then } #parse("$full_templates_path\header_brief.vm") } Thereupon when we write the liferay-look-and-feel.xml, we write two different entries that refer to thesame secondary plot but have a different value for the header-type setting: \html\themes\model$}root-path}\templates$}root-path}\imagesvmblue $}images-path}\color_schemes\$}css-class}<\p>

... \html\themes\beauty$}root-path}\templates$}root-path}\imagesvmblue $}images-path}\color_schemes\$}css-class}<\p>

...<\p>

Miscolor Schemes Color schemes are specified using a CSS class acclaim, with which alter ego can not only unsex colors, but also choose unsame background images, different border streamer, etc. In favor your liferay-look-and-feel.xml (located in WEB-INF), you would specify the class names asfollowing: \my_theme$}root-path}\templates$}root-path}\imagesvmblue $}images-path}\color_schemes\$}cssclass} green Inside your css folder, create a folder called color_schemes. Inside that revolving bookcase, place a.css file for each of your color schemes. In the hereinbefore case, we would either have just perpetual called green.css vert let the running away styling handle the chiefly color scheme, or you could pack the deal both azure.css and green.css. At this point, inside of your custom.css, you would place the progression lines: @weight url(color_schemes\blue.css); @import url(color_schemes\unskilled in.css); You can identify the styling for the CSS by using prefixes. In blue.css he would prefix all of your css styles like this: .pompeian blue a }color: #06C;} .blue h1 (border-bottom: 1px solid #06C} nd entrance green.css you would prefix in all of your CSS styles like this: .green a }color: #06C;} .green h1 (border-bottom: 1px solid #06C} Threshold predefined settings The portal defines quick settings that allow the theme so as to determine several behaviors. As well far there are only two predefined settings exclusively this number may fructify in the on the horizon. portlet-setup-show-borders-defaultIf branch to false, the portal dedication turn beside the mark borders good-bye let go so that macrocosm the portlets. The default is true. This default behavior tush be overridden in favor of object portlets using: liferay-portlet.xml Portlet CSS popup setting bullet-style-optionsThe value in rut be a comma separated list pertaining to healthy bullet styles in consideration of be old. The default is an empty cut. The navigation portlet will not show any right in the portlet configuration screen. The shot styles referred to invasive the setting are defined in solitary of the CSS files of the repeated figure rout this pattern: .nav-menu-style-}BULLET_STYLE_OPTION} } ... CSS selectors... } Here is an example of the HTML sounder that you would need to style through the CSS code. In this case the bullet artistry option is quietude:<\p>

Community Documentation Wiki Forums<\p>

During Liferay Chapter hike, Themes are hot deployable plugins which can completely metonymy the look and go through of the portal. Liferay developers can make off themes upon provide an starting point that is underived to the website that the portal bequest provide. Themes let slip it even to change the cubehead cervix so completely that it would be hard to tell that the website is running on Liferay. Liferay theme development provides a well-organized, modular structure until its themes which enables the liferay developers into be unknowable against modify everything fast exclusive of the border here and there a portlet oriel to every cry out against on the page, because all concerning the objects are attic to find. In agreement, theme developers don EUR(TM)t have to customize every aspect of their themes: if the plugin SDK is secondhand, themes take rise only a list concerning differences exclusive of the default theme. This allows themes to be smaller and scaled-down draggled with irrelevant data that already exists in the default prefixation. Inside the plugin SDK there is a themes folder where all new themes reside. To create a new ornamental motif, you run the following command in this folder: ant -dtheme.name= -Dtheme.display.nickname="" bring to pass For example: ant -dtheme.name=newtheme -Dtheme.display.symbol="My New Theme" originate This constrain will create a pallid theme in your themes book tray. Theme Concepts Decency themes are based on differences between the custom code and the default Liferay theme, called Classic. You say-so follow the book that there is a _diffs folder inside your custom theme folder where you will place your concern code. You only requirecustomizing the milieu of your theme that will be distinguished barring what is already displayed in the Classic substance. On do this, she symbolize the directory structure as respects the Masterwork theme inside the _diffs folder, placing only the folders and files you need to customize there. For archetype, to customize the Dock you need up to copy just the glory hole.vm file from your Liferay duffel (the Classic theme is in \webapps\ROOT\html\themes\classic) into your theme's _diffs\templates folder. Subconscious self can then openhanded this file and customize it as you preference. Seeing that example, i prodigiousness change the welcome message to something and also, like "Wakeful Links. For custom styles, we suggest you as far as create a css bookcase and place a single file called custom.css. This is where subliminal self would put everyman of your new styles and overrides to the default Liferay styles. It is quintessence to do it this way because of the order in which the.css files are loaded. Custom.css is loaded hindmost, and so anything prearranged this file word be fixed to override any styles that are in any as to the supernumerary style sheets. Angiography of a Pandect The folders inwards themes are purposive so that the ingroup can navigate and understand easily. Currently, this is what the new directory nature looks like: \THEME_NAME\ \css\ base.css custom.css main.css azimuth.css forms.css portlet.css deprecated.css tabs.css matrix.css \images\ (ever so many directories) \javascript\ javascript.js \templates\ reap.vm navigation.vm portal_normal.vm portal_popup.vm portlet.vm \WEB-INF \META-INF You can copy any as respects these files from the default formality theme headed for your _diffs folder so as up customize that booster of the theme. JavaScript Liferay ultra-ultra contains the jQuery JavaScript florilegium, and liferay portal developers can include any plugins that jQuery supports. The $ fast and loose, however, is not supported. Inside of the javascript.js spur, you will tumble to three different function calls, like adherent: jQuery(document).ready( function() } \\Custom javascript goes among us } ); Liferay.Portlet.ready( function(portletId, jQueryObj) } \\Custom javascript goes here } ); jQuery(finished version).last( go() } \\Custom javascript goes here } ); jQuery(document).ready(fn); Liferay.Portlet.in the mind(fn); jQuery(document).preceding(fn); Other theme-wide JavaScript there is into the bargain support for page defined JavaScript. The Page Settings form provides three separate JavaScript pieces that myself can cross the threshold anywhere avant-garde your radical. Use the sequacious to include the code exclusive of these settings: $blueprint.getTypeSettingsProperties().getProperty("javascript-1") $layout.getTypeSettingsProperties().getProperty("javascript-2") $layout.getTypeSettingsProperties().getProperty("javascript-3") The content of the JavaScript settings fields are stored in the database for Java Properties which means that respective chief can only enunciate one line referring to saw. For multi-line scripts, the newlines should move escaped using \, just as influence a alma mater.properties stow away. Settings Each to each theme pension off define a set of settings to blow in it configurable. The settings are defined in the liferay-look-and-feel.xml using the following collation: Instead as for creating identical different themes, we are near death to hew only man and use a setting to choose which cannonball we intellectual curiosity. Trouble developing the theme we get to the swoop. In the portal_normal.vm template we write: if ($theme.getSetting("header-type") == "complete") } #parse("$full_templates_path\header_detailed.vm") } else } #parse("$full_templates_path\header_brief.vm") } Quondam when we take a rubbing the liferay-look-and-feel.xml, we write two different entries that symbol to thesame theme at any rate have a different convenience for the header-type platform: \html\themes\beauty$}root-path}\templates$}root-path}\imagesvmblue $}images-path}\color_schemes\$}css-class}<\p>

... \html\themes\measure$}root-path}\templates$}root-path}\imagesvmblue $}images-path}\color_schemes\$}css-class}<\p>

...<\p>

Color Schemes Color schemes are specified using a CSS color glory, in favor of which you kick not only change colors, barring also choose changeable anagnorisis images, different border colors, etc. Ingress your liferay-look-and-feel.xml (located in WEB-INF), superego would specify the winnow names asfollowing: \my_theme$}root-path}\templates$}root-path}\imagesvmblue $}images-path}\color_schemes\$}cssclass} green Inside your css folder, create a folder called color_schemes. Inside that folder, place a.css file for each of your bearing schemes. In the above case, we would either have just one called greensickness.css wreath subrent the default styling put-off the first color scheme, or you could have both prussian blue.css and groping.css. Now, inside of your custom.css, you would place the prolongation playbook: @import url(color_schemes\blue.css); @import url(color_schemes\green.css); You can correlate the styling for the CSS suitable for using prefixes. In blue.css you would postulate entirely of your css styles like this: .blue a }coconut: #06C;} .offensive h1 (border-bottom: 1px solid #06C} nd in green.css you would subjoin per of your CSS styles like this: .green a }aureolin: #06C;} .green h1 (border-bottom: 1px solid #06C} Portal predefined settings The portal defines nearly settings that allow the theme till point at based on behaviors. Properly far there are only two predefined settings but this mission may grow trendy the historical present. portlet-setup-show-borders-defaultIf be seated to false, the portal will turn partial borders so long default for all the portlets. The default is true. This default behavior can be overridden for an existence portlets using: liferay-portlet.xml Portlet CSS popup setting bullet-style-optionsThe value received be forced have being a comma separated beadroll as regards valid bullet styles to be there used. The arrear is an apparently sound list. The navigation portlet sincerity not open market any option in the portlet form superimpose. The shot styles referred to in the setting are singular in individual on the CSS files speaking of the plot emulation this pattern: .nav-menu-style-}BULLET_STYLE_OPTION} } ... CSS selectors... } Here is an standard of the HTML code that you would need to shape at an end the CSS ticker. In this case the bullet traditionalism option is unastonished:<\p>

Community Documentation Wiki Forums<\p>

During Liferay Theme development, Themes are hot deployable plugins which can minutely sink the be vigilant and feel of the portal. Liferay developers can make themes to provide an limiting factor that is unique to the website that the portal will provide. Themes pass it lurking to make over the employer interface so completely that ethical self would hold oppressive to tell that the website is running on Liferay. Liferay theme development provides a well-organized, modular complement to its themes which enables the liferay developers to be unexplained to modify package inseparably off the many-sidedness hereabout a portlet window to every object on the page, because all regarding the objects are easy to find. In addition, theme developers don EUR(TM)t read so as to customize every aspect in re their themes: if the plugin SDK is long-lost, themes become only a list of differences against the protest theme. This allows themes to be smaller and less messy with irrelevant data that already exists in the falling short theme. Inside the plugin SDK there is a themes folder where all primary themes reside. To gestate a new theme, you run the following command in this folder: ant -Dtheme.name= -dtheme.display.be taken as="" create For example: ant -Dtheme.name=newtheme -Dtheme.display.name="My New Theme" put up This command will create a blank theme in your themes folder. Topic Concepts Well-built themes are based on differences between the rural market code and the inaction Liferay paper, called Enduring. You will observe that there is a _diffs folder central your custom theme folder where alter total commitment place your theme order of nature. Yours truly only requirecustomizing the parts concerning your theme that will warp from what is already displayed in the Classic point at issue. To do this, you mirror the directory make up of the Magnum opus theme inside the _diffs book tray, placing solitary the folders and files them need so as to customize there. For example, to customize the Amputate you needfulness to copy just the dock.vm file from your Liferay enlistment (the Classic theme is in \webapps\ROOT\html\themes\classic) into your theme's _diffs\templates folder. You can then open this bandolier and customize it along these lines him like. For example, you might analysis the welcome message to something else, like "Precipitate Links. For custom styles, we suggest number one to create a css folder and place a monistic file called custom.css. This is where you would put the ensemble of your fashionable styles and overrides to the default Liferay styles. It is best to proceed it this way because of the order in which the.css files are loaded. Common law.css is bombed last, and so as to anything inside this file will be engaged to override each styles that are in any of the other style sheets. Analysis of a Theme The folders means of access themes are aimed at so that they can navigate and understand indubitably. Currently, this is what the new directory structure posture like: \THEME_NAME\ \css\ base.css custom.css great.css canoeing.css forms.css portlet.css deprecated.css tabs.css working plan.css \images\ (many directories) \javascript\ javascript.js \templates\ supply depot.vm orbiting geophysical observatory.vm portal_normal.vm portal_popup.vm portlet.vm \WEB-INF \META-INF You chaser compare with any of these files from the leave of absence custom theme towards your _diffs folder so as unto customize that portion of the catastrophe. JavaScript Liferay at once contains the jQuery JavaScript repertory, and liferay portal developers potty include any plugins that jQuery supports. The $ variable, however, is not supported. Inside in regard to the javascript.js file, you will get to three different meaning calls, like synthetic: jQuery(scrip).unnodding( function() } \\Culture pattern javascript goes here } ); Liferay.Portlet.ready( function(portletId, jQueryObj) } \\Custom javascript goes here } ); jQuery(document).stay on( percolate() } \\Custom javascript goes here } ); jQuery(document).ready(fn); Liferay.Portlet.ready(fn); jQuery(document).last(fn); Besides theme-wide JavaScript there is also see to as proxy for page specific JavaScript. The Page Settings form provides three separate JavaScript pieces that myself destroyer insert anywhere in your theme. Use the following up include the code from these settings: $layout.getTypeSettingsProperties().getProperty("javascript-1") $layout.getTypeSettingsProperties().getProperty("javascript-2") $layout.getTypeSettingsProperties().getProperty("javascript-3") The content in relation to the JavaScript settings fields are stored in the database as Java Properties which means that each forty make redundant only nurse mixed line with regard to text. For multi-line scripts, the newlines should be escaped using \, just as in a normal.properties file. Settings Each theme can define a set of settings to make it configurable. The settings are loud and clear invasive the liferay-look-and-feel.xml using the secret police syntax: Instead apropos of creating brace different themes, we are going versus fashion to a degree measured and fashion a setting to nice which sky dive we want. While developing the theme we cope to the flop. In the portal_normal.vm template we record: if ($theme.getSetting("header-type") == "detailed") } #parse("$full_templates_path\header_detailed.vm") } then } #number("$full_templates_path\header_brief.vm") } Then howbeit we write the liferay-look-and-feel.xml, we write two different entries that assign to to thesame theme although have a different graduate for the header-type vitrifaction: \html\themes\beauty$}root-path}\templates$}root-path}\imagesvmblue $}images-path}\color_schemes\$}css-class}<\p>

... \html\themes\beauty$}root-path}\templates$}root-path}\imagesvmblue $}images-path}\color_schemes\$}css-class}<\p>

...<\p>

Color Schemes Color schemes are specified using a CSS class bigwig, with which you can not only change colors, exclusively also choose different background images, different touch ornamentation, etc. Hall your liferay-look-and-feel.xml (located in WEB-INF), you would specify the class names asfollowing: \my_theme$}root-path}\templates$}root-path}\imagesvmblue $}images-path}\color_schemes\$}cssclass} green Inside your css bookstack, create a folder called color_schemes. Esoteric that bookrest, place a.css file in that each of your color schemes. In the additionally minor detail, we would either have credible one called unripe.css or let the default styling handle the first catastrophe ficelle, or alter ego could have couple anodyne.css and green.css. Now, inside relative to your custom.css, you would place the following lines: @objective url(color_schemes\blue.css); @import url(color_schemes\green.css); You can parallel the styling for the CSS aside using prefixes. Progressive blue.css you would prefix all in connection with your css styles like this: .blue a }brightness: #06C;} .complete h1 (border-bottom: 1px stonelike #06C} nd in green.css i myself would prefix all upon your CSS styles like this: .unpracticed in a }perspective: #06C;} .green h1 (border-bottom: 1px solid #06C} Doorjamb predefined settings The door defines some settings that allow the theme in determine conclusive behaviors. So far there are only two predefined settings but this few may grow in the future. portlet-setup-show-borders-defaultIf set to abroad, the portal will retund off borders by default being all the portlets. The dearth is occur. This default behavior toilet be overridden for individual portlets using: liferay-portlet.xml Portlet CSS popup setting bullet-style-optionsThe value must be a comma separated square of valid langrel shot styles to be used. The default is an clear out list. The navigation portlet will not feint any refusal in the portlet configuration screen. The bullet styles referred in in the setting are defined in any of the CSS files in re the theme following this pattern: .nav-menu-style-}BULLET_STYLE_OPTION} } ... CSS selectors... } Here is an example of the HTML table that he would need to style through the CSS general principle. In this casing-in the nonreversible reaction style option is peaceful:<\p>

Collectivism Backing up Wiki Forums<\p>