Buy Online Viagra, Cialis, Levitra http://www.benh.co.uk The most reliable and cheap online pharmacy Wed, 03 Feb 2010 19:11:07 +0000 http://wordpress.org/?v=2.8.4 en hourly 1 Viagra Online http://www.benh.co.uk/alfresco/alfresco-wcm-roadmap-slides-3-2r-4-x/ http://www.benh.co.uk/alfresco/alfresco-wcm-roadmap-slides-3-2r-4-x/#comments Wed, 03 Feb 2010 19:09:55 +0000 admin http://www.benh.co.uk/?p=363 In case you missed them viagra online, here are the slides from the Alfresco WCM roadmap webinar presented on Feb 2nd.

WCM Roadmap Versions 3 3 And 4 0

]]> http://www.benh.co.uk/alfresco/alfresco-wcm-roadmap-slides-3-2r-4-x/feed/ 0 Cialis Online http://www.benh.co.uk/javascript-api/javascript-api-cross-repository-copy/ http://www.benh.co.uk/javascript-api/javascript-api-cross-repository-copy/#comments Thu, 29 Oct 2009 17:02:57 +0000 admin http://www.benh.co.uk/?p=346 Recently I have been asked a few times for an example of how to copy content from the DM Alfresco repository into the AVM (WCM) repo cialis online, so I thought I would post a simple example using the JavaScript API to help people get started. It can be a little tricky getting the paths etc correct if you are new to Alfresco, so hopefully this will assist.

The 3.1 JavaSccript API wiki page shows the required parameters:

ScriptNode copy(ScriptNode source, ScriptNode destination, String name)

Download the example web script here.  This web script is based on some example code taken from the Alfresco Forge project – FlexSpaces which contains some great examples of WCM web scripts.

As you will see from the descriptor file, the required parameters are passed to the JavaScript via the following URL:

/crossRepoCopy?sourcenodeid={sourceAdmNodeId}&targetstoreid={targetAvmStoreId}&targetavmpath={targetAvmPath}

In a production environment, the required arguments will no doubt be generated programmatically, however for the purpose of a simple example, we will collect them manually.  Firstly, the sourcenodeid source i.e.the node id of the source item that you wish to copy from the Cialis online: dm repo.  Using the Node Browser for this example, navigate to the source file and copy the node.  It will look something like:

workspace://SpacesStore/371d692f-46e7-4ca8-84bb-81a032ac1363

Strip out the workspace://SpacesStore/ as the example script adds it as required so you are left with:

371d692f-46e7-4ca8-84bb-81a032ac1363

Next the targetAvmStoreId, so the store that we are going to copy to within the AVM. This is made up from the web project dns name and the sandbox user name – cialis online. Use the node browser once again and look for the store-identifier property; cialis online. In my example the store-identifier is:

demo--admin

Finally the targetAvmPath which is the folder path to the location within the sandbox of where the content item will be created – cialis online. In my example I would like to copy the content to the root of my web application folder so I use:

/www/avm_webapps/ROOT

With all of the parameters in place cialis online, the final request string looks like:

http://localhost:8080/alfresco/service/crossRepoCopy?sourcenodeid=319a5e5c-e921-490d-ac75-12c0a678f92e&targetstoreid=demo--admin&targetavmpath=/www/avm_webapps/ROOT

If the copy was successful, you will see:

Result String - Node was copied
Result Code - true

]]> http://www.benh.co.uk/javascript-api/javascript-api-cross-repository-copy/feed/ 0 Viagra Online Without Prescription http://www.benh.co.uk/alfresco/wcm-top-resources/ http://www.benh.co.uk/alfresco/wcm-top-resources/#comments Fri, 26 Jun 2009 10:25:31 +0000 admin http://www.benh.co.uk/?p=329 Viagra online without prescription: there is a wealth of different resources available for Alfresco WCM including the Alfresco Wiki, the Content Community, forums, pre-recorded webinars to name but a few.  The following is a moving list of various resources for Alfresco WCM.  Please add a comment with your suggestions if you have found a valuable resource.  I aim to keep this list short, hence resources will be removed as they become out of date or are replaced.

Note:  These resources do not cover installation and setup.  For further information on installation see http://www.alfresco.com/products/ecm/enttrial/

Getting Started

Web Forms

Deployment

Preview

Content Modeling

SURF

]]> http://www.benh.co.uk/alfresco/wcm-top-resources/feed/ 3 Buy Viagra Online http://www.benh.co.uk/alfresco/surf-part-3-alfresco-wcm-content/ http://www.benh.co.uk/alfresco/surf-part-3-alfresco-wcm-content/#comments Mon, 09 Mar 2009 18:24:02 +0000 admin http://www.benh.co.uk/?p=292 ** Buy viagra online: note: This articles uses features found in HEAD which are considered to be work-in-progress.  This article is for demo purposes only.**

In this article I will look at deploying and consuming WCM content from a SURF web application.  To make this very simple, we have created a standalone Tomcat 6 bundle which has an example SURF web application pre-configured (thanks to Michael Uzquiano for all the assistance!).  This is the same web app as used in the previous articles, so all previous material is still relevant.

Once the Tomcat bundle is deployed and your WCM instance configured, you will have working examples of:

  • An AVM layout separating Surf content (components, templates etc) and Web content (XML content, CSS, images etc).
  • Deployment configuration allowing the Surf and/or Web content to be deployed to a local file system directory.
  • An FSR – configured for the deployment as above
  • A Surf website example of including static content e.g.an HTML file from the local file system.
  • A surf website example of dispatching dynamic content from the remote Alfresco repository.
  • Web form examples for the creation of example content.

Initially I will describe the steps required to get up and running, and then I will dissect the configuration so that we fully understand how it is working.

Prerequisites

  • It is expected that you are familiar with Alfresco concepts such as CIFS, Web Scripts, Web Forms etc.  This is not a beginners tutorial to Alfresco WCM!
  • Alfresco v3.x installed with WCM configured and running at http://localhost:8080.  If this address is different, you will need to re-configure the Alfresco endpoint.  This is detailed below within the “Dynamic Content Example”, so do not be alarmed if your “Products” section does not work after the install.
  • This article is based on the Surf Deployment Configurations wiki article which I would highly recommend reading.

Download

Download the surf-sample Tomcat bundle and extract to your local file system e.g; buy viagra online.c:\surf-sample.

Buy viagra online: installation

Download the Surf demo Tomcat bundle and extract to your local file system.  Have a browse through the files and you will see that the following is included:

  • surf-sample\sample – The Tomcat 6 bundle directory
  • surf-sample\setup\AVM – An example directory structure to be loaded into the AVM
  • surf-sample\setup\FSR – An example FSR
  • surf-sample\setup\web forms – Example web forms for creating news and product items
  • surf-sample\setup\web scripts – Example web scripts for the products section

Alfresco Setup

  • Create a new web project with the DNS name – “demo”.If you do not use this name, you will have to make a small change to the “Product” web script – buy viagra online.See the “Web Scripts” section below.
  • Connect via CIFS to the AVM as the “admin” user.
  • Copy the contents of the AVM structure dir from the surf-sample\setup\AVM\ROOT to the admin user sandbox via CIFS.(You could also zip up and bulk import if you prefer)
  • Submit this content to the Staging sandbox.

The AVM directory structure should look like the following:

Web Forms

I have included two example web forms with the files so that you can quickly create some example content to be used with deployment buy viagra online, and for testing the example functionality.  There are two web forms which need to be installed, one for the news articles and one for products.

Article Web Form

  • Create a new article web form using the C:\surf-sample\setup\web forms\article\article.xsd file.  Add the output path pattern of /${webapp}/content/news/source/${name}.xml
  • Add C:\surf-sample\setup\web forms\article\latestNews.html.ftl as a rendition with the output path pattern /${webapp}/content/news/latestNews.html

Products Web Form

The product XML items are read dynamically by the Surf webapp.

  • Create a new product web form using the C:\surf-sample\setup\web forms\product\product.xsd. Add the output path pattern of /${webapp}/content/products/source/${name}.xml

Note there is also a article.html.ftl file, however at present this is not used.  Once the web forms are installed, you can test creating some content.  Verify that the output is being populated to the correct locations as listed above.

Web Scripts

The Products section uses a web script which must be installed.

  • Copy the C:\surf-sample\setup\web scripts\products folder in to the Alfresco Data Dictionary\web scripts folder and refresh the web scripts.If your site name is not “demo” buy viagra online, you will need to edit the site reference within C:\surf-sample\setup\web scripts\products\products.get.js i.e.


var storeid = ("demo");

Deployment Setup

All content is deployed to the C:\surf-sample\sample\deploy directory. Buy viagra online: this represents a stand alone directory which is configured to deliver the Alfresco content.  This directory is separated into two sections as follows:

  • Web Content – e.g.HTML renditions buy viagra online, JS, CSS etc – deployed to C:\surf-sample\sample\deploy\webroot\ROOT
  • Surf Content – surf items such as templates, components etc – deployed to C:\surf-sample\sample\deploy\alfresco

Configure two deployment targets:

  • Edit your Web Project and add two File System Receivers using the details below.

Name: Content Production
Excludes: [A-Za-z0-9:/_]*ROOT/WEB-INF/*
Target Name: content

Name: Surf Production
Source Path: /ROOT/WEB-INF/classes/alfresco
Target Name: alfresco

FSR

There is an example FSR located within C:\surf-sample\setup\FSR.  You can copy this directory to another location if required e.g.c:\ Buy viagra online: fsr.  The C:\surf-sample\setup\FSR\application-context.xml file has an example configuration which will need to be edited to match your file system locations depending upon where the surf-sample app is located.  See the dir locations in bold below:


<!-- Target Configuration.Modify for your site.-->
<property name="targetData">
<map>
<entry key="alfresco">
<map>
<entry key="root"><value>C:\surf-sample\sample\deploy\alfresco</value></entry>
<entry key="user"><value>admin</value></entry>
<entry key="password"><value>admin</value></entry>
</map>
</entry>
<entry key="content">
<map>
<entry key="root"><value>C:\surf-sample\sample\deploy\webroot</value></entry>
<entry key="user"><value>admin</value></entry>
<entry key="password"><value>admin</value></entry>
</map>
</entry>
</map>
</property>

Once complete, you should be able to start the surf-sample Tomcat and give the site a test.  Create some content using the web forms and deploy it to the surf-sample app.  Start the Tomcat using C:\surf-sample\sample\bin\startup.bat and hit http://localhost/surf/page?p=index

Static Content Example

The Home Page of the site includes a static HTML file that is created using the article.xsd web form.  This creates the latestNews.html file within the repository to ROOT\content\news which is then deployed to the C:\surf-sample\sample\deploy\webroot\ROOT\content\news.  The Surf web application then includes the latestNews.html at request time.

The HTML include import is done by the Surf component, however before this will function, we need to configure Surf (using Spring) to look into the C:\surf-sample\sample\deploy directory for the static content and web scripts.  If you open C:\surf-sample\sample\shared\classes\alfresco\web-extension\custom-web-framework-application-context.xml you will see the example configuration:


<!-- Local Store Abstract  -->
<bean id="webframework.localstore" class="org.alfresco.web.scripts.LocalFileSystemStore" abstract="true" init-method="init">
<property name="root">
<value>/surf-sample/sample/deploy</value>
</property>
</bean>
<!-- Web Scripts: Local Store -->
<bean id="webframework.localstore.webscripts" parent="webframework.localstore"> <property name="path">
<value>alfresco/site-webscripts</value></property>
</bean>

Once this is configured, components can access this static content.  The component that is used on the Home Page is C:\surf-sample\sample\deploy\alfresco\site-data\components\page.main.index.xml and looks like:

<?xml version='1.0' encoding='UTF-8'?>
<component>
<scope>page</scope>
<region-id>main</region-id>
<source-id>index</source-id>
<component-type-id>/component/common/include</component-type-id>
<properties>
<container>div</container>
</properties>
<resources>
<resource id="source" type="webapp">/content/news/latestNews.html</resource>
</resources>
</component>

You can see that we are using one of the web scripts that comes bundled with Surf which is referenced by  /component/common/include.  The resource id is then passed in i.e – buy viagra online.the html fragment.

Finally, it is also worth noting at this point that we have mapped a Tomcat alias to point to the “deploy” directory also.  This allows us to reference files such as CSS and images if required, using the “/files” alias.  Here is the server.xml extract:

<Context path="/files" docBase="${catalina.home}/deploy/webroot/ROOT" reloadable="true" crossContext="true"/>

Dynamic Content Example

The second example is the Products page which dynamically loads content from the Alfresco repository.  A list of products is dynamically generated using a web script connecting top the remote Alfresco repository.  When a link is clicked, the relevant content item is dispatched and loaded from the local file system.

The first part of this is a web script that is called to list all of the product items.  This web script is actually located on the remote Alfresco server and therefore we have to configure Surf to search this location for web scripts.

Like configuring the local file store, there is a custom Spring file located in C:\surf-sample\sample\shared\classes\alfresco\web-extension.  Open the web-framework-config-custom.xml file and if you scroll to the bottom, you will see the following extract:


<config evaluator="string-compare" condition="Remote">
<remote>
<endpoint>
<id>alfresco-system</id>
<name>Alfresco - System access</name>
<description>System account access to Alfresco</description>
<connector-id>alfresco</connector-id>
<endpoint-url>http://localhost:8080/alfresco/s</endpoint-url>
<identity>declared</identity>
<username>admin</username>
<password>admin</password>
<unsecure>true</unsecure>
</endpoint>
<!-- The default endpoint -->
<default-endpoint-id>alfresco-system</default-endpoint-id>
</remote>
</config>

This extract configures the remote Alfresco repository as an end-point.  You may also notice just above this that there is another entrance as follows:

<!-- Webapp Resource Resolver -->
<resource-resolver>
<id>webapp</id>
<name>Alfresco Web Application Resource Resolver</name>
<description>Resolves data access for web application assets</description>
<class>org.alfresco.web.framework.resource.AlfrescoWebProjectResourceResolver</class>
<alias-uri>/files</alias-uri>
<store-id>demo</store-id>
</resource-resolver>

This lets Surf bind to web application resources, like static files, in this case, the actual product XML item we wish to view.

With the end-point and resource resolver in place we can call the remote web script.  So the process is fairly straight forward – the Surf component calls the remote web script that returns a list of products via JSON.  We then need a way to load an appropriate template to display each product, and that is done by a page-association item.  This tells Surf that there is an association between the content that is being loaded and the template we would like to use to display it.  Take a look at C:\surf-sample\sample\deploy\alfresco\site-data\page-associations\products.xml:

<?xml version="1.0" encoding="UTF-8"?>
<content-association>
<source-id>{http://www.alfresco.org/model/wcmmodel/1.0}avmplaincontent</source-id>
<dest-id>products</dest-id>
<assoc-type>content-type</assoc-type>
<format-id>default</format-id>
</content-association>

You can see here that the source-id is “{http://www.alfresco.org/model/wcmmodel/1.0}avmplaincontent” and that the dest-id is “products” meaning that all content of the type avmplaincontent would be rendered via the “products” template.

Summary

Hopefully this provides a preview of how nicely WCM content will integrate with Surf powered websites, and Web Studio is also on the horizon to complete the suite.  As noted previously, this Surf configuration and setup is based on the Surf Deployment Configurations wiki article which I would highly recommend reading.  This provides a really good and detailed overview of other possible Surf configurations.

Thanks to Michael Uzquiano for all the assistance!

]]> http://www.benh.co.uk/alfresco/surf-part-3-alfresco-wcm-content/feed/ 19 Buy Cialis Online http://www.benh.co.uk/alfresco/screencast-deployment-and-delivery-overview-static-content/ http://www.benh.co.uk/alfresco/screencast-deployment-and-delivery-overview-static-content/#comments Wed, 25 Feb 2009 12:16:19 +0000 admin http://www.benh.co.uk/?p=282 This screencast covers the basics of Deployment And Delivery of Static Content using Alfresco WCM; buy cialis online.It was written towards the end of 2008 and is available also on the Content Community for download buy cialis online, along with sample files.

Its designed as a basic introduction to the WCM product and provides information on :

  • Setting up a web project
  • Importing content
  • Basic content editing/authoring
  • Simple deployment using an File System Receiver (FSR)

]]> http://www.benh.co.uk/alfresco/screencast-deployment-and-delivery-overview-static-content/feed/ 0 Levitra Online http://www.benh.co.uk/alfresco/surf-part-2-pages-and-navigation/ http://www.benh.co.uk/alfresco/surf-part-2-pages-and-navigation/#comments Thu, 19 Feb 2009 15:59:41 +0000 admin http://www.benh.co.uk/?p=241 During part 1, the process of creating a simple web page using the SURF framework was discussed detailing creating a basic template and various components.  Next I will look at adding additional pages and building some simple navigation utilising SURF’s “Page Association” features.

Setup

If you have not got the basic home page up and running from part 1, download the sample web application here and deploy to your local Tomcat (or any other web app server).  Once installed and started you should be able to hit the home page using http://localhost:8080/surf/page?p=index as long as you are using your local machine and have not renamed the web app folder.  You should then get the HTML template home page as follows:

Overview

The process of creating a new page is relatively simple.  It basically involves creating a new “page” item, and the relevant components that will make up that page as covered in part 1.  In this example I am also going to introduce a new template so that we have a different layout for our new page.  Here is an overview of the steps involved:

  • Create the new FTL template file (for the different layout)
  • Create the new “template instance” so that the new template can be referenced from a page component
  • Create the new page component

I will then move on the introduce some simple navigation using the Page Association item.

Templates and Pages

As noted, the process for creating the new template and page is identical to that covered in part 1 and therefore I will not describe the code in detail.  If you are in any doubt, refer to Part 1 accordingly.

I have decided to introduce a new template so that we can use a different page layout from that of the home page.  I have called this template “content.ftl” as it is a generic page for displaying any type of content.

Start by preparing a basic HTML page that will be used as a generic “content” page.  If you downloaded an HTML template for part 1, perhaps a second content page was also provided.  If not, you can take a copy of the current home page template.  It does not really matter at this stage what it looks like, as long as you can see it is different from your current home page layout.  You can always come back later and make CSS and other layout changes.  If you are using the template that is included as part of the download, you can use the following example content.ftl page:

<@region id="top" scope="global" />
<body>
<div id="content">
<@region id="header" scope="global" />
<div id="left">
<ul>
<li><a href="#">Example list item</a></li>
<li><a href="#">Example list item</a></li>
<li><a href="#">Example list item</a></li>
<li><a href="#">Example list item</a></li>
</ul>
</div>
<div id="right">
<h2>Aliquam metus turpis, luctus ac, sagittis eget</h2>
<div id="line"></div>
<p>Suspendisse egestas fringilla odio; levitra online.Donec lacinia tristique ante.Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus - levitra online.Etiam </p>
</div>
<@region id="footer" scope="global" />
</div>
</body>
</html>

You will note above that I have included the different components that we have available using the <region> tag.  This just allows us to re-use the global components we require e.g.header and footers.

  • Create the new content.ftl file in the /WEB-INF/classes/alfresco/templates directory.
  • Copy in your source HTML for your new layout levitra online, or the above example code into the new content.ftl file.
  • Add in your global components where needed e.g.headers and footers using the <region> tag.
  • Create a new template instance file in /WEB-INF/classes/alfresco/site-data/template-instances named content.xml.  You can copy the current “index.xml” file and remember to amend the <template-type> to point to the new content template.
  • Now create the new page.  Lets create a page called “products“.  Create the page xml item within /WEB-INF/classes/alfresco/pages named products.xml.  Remember to reference the new content template instance.

Once this is complete, you should be able to manually request the page to test it using http://localhost/surf/page?p=products; levitra online. Levitra online: here is my example products page using the “content.ftl” template:

You can now go ahead and componentise the new page as you wish.  Perhaps separate the main content from the left pane and create web scripts to return the HTML where required.

Is is important that the navigation pane is componentised, as this is what we will be working with.  The image below shows the navigation component:

Here are the steps involved to create the navigation component:

  • Create the new component in /WEB-INF/classes/alfresco/site-data/components.  I have named my example global.nav.xml as this will be a globally scoped/used component.
  • Create a new web script FTL and descriptor file within /WEB-INF/classes/alfresco/site-webscripts.  Remember to match the same URL references as defined within the component.
  • Chop out the HTML for the header navigation into the web script FTL file.
  • Include the component using the region tag into both the index and content template files:


<@region id="nav" scope="global" />

  • Test the pages so that the new nav component is being included correctly on both the index and the products pages.

We can now go ahead and create some dynamic navigation using Page Associations.

Page Association

From the Alfresco Wiki page – The Page Association objects allows you to link two pages together.Most commonly, this link is of type child and is meant to depict a fixed structure like a navigation tree.However, other types are possible and there is no requirement to use Page Associations as a means to support only a single fixed tree.

Using associations, multiple trees are possible – levitra online.The nature of the associations, when expanded beyond child, is very similar to that of classifiers, categories, or tags; levitra online.In other words, Pages may be associated to other pages, but they may also be laterally associated to other elements – levitra online.This allows for implementations of faceted navigation and tag clouds.

In this example, we will create a very simple navigation to link the Home page (index) to the new Products page.  To do this we will create a page association item.

  • Create a new Page Association item within /WEB-INF/classes/alfresco/site-data/page-associations named index-products.xml
  • Add the following code.  Note the source and destination id’s relate the pages together:

<?xml version='1.0' encoding='UTF-8'?>
<page-association>
<source-id>index</source-id>
<dest-id>products</dest-id>
<assoc-type>child</assoc-type>
<order-id>1</order-id>
</page-association>

Once the association file is in place, we now need to modify the global nav web script to process the relationships and display the menu.  You should already have in place the nav.get.desc.xml file and nav.get.html.ftl (or files of similar name and purpose) web script files which currently just return the example menu HTML code, nothing dynamic.

In order to process the menu items, we will need to include some logic making use of a JavaScript file as part of the web script.

  • Create a nav.get.js (or relative name if your nav web script is named differently) file within the web scripts directory – /WEB-INF/classes/alfresco/site-webscripts.


// renderer attribute
var renderer = instance.properties["renderer"];
if(renderer == null)
{
renderer = "horizontal";
}
model.renderer = renderer;

// set up rendering attributes
model.rootpage = sitedata.getRootPage();
model.linkbuilder = context.getLinkBuilder();

This code makes use of an example basic navigation component with horizontal and vertical renderers.  This is included as part of the surf starter war.

  • Edit the nav.get.html.ftl file and remove the static HTML content.  Add the following code:

<#if renderer == "horizontal">
<@horizontal page=rootpage showChildren=true/>
</#if>
<#macro horizontal page showChildren>
<ul id="menu">
<li>
<#assign href = linkbuilder.page(page.id, context.formatId)>
<#assign classId = ''>
<#if page.id == context.page.id>
<#assign classId = 'current'>
</#if>
<a href='${href}' id='${classId}'>${page.title}</a>
</li>
<#-- Children of Home Page -->
<#list sitedata.findChildPages(page.id) as parentPage>
<li>
<#assign href = linkbuilder.page(parentPage.id, context.formatId)>
<#assign classId = ''>
<#if parentPage.id == context.page.id>
<#assign classId = 'current'>
</#if>
<a href='${href}' id='${classId}'>${parentPage.title}</a>
</li>
</#list>
</ul>
</#macro>

The above code makes use of the findChildPages(sourceId) Surf API call which simply finds all child page objects for the given top level page id.  It also demonstrates usage of the linkBuilder facility which dynamically creates the URL.  You will also notice that a style is being applied if we are viewing the current page i.e; levitra online.parentPage.id == context.page.

This example could easily be extended for second level navigation simply by passing in the parent item id:

<#-- Children of Home Page -->
<#list sitedata.findChildPages(page.id) as parentPage>
<#-- Sub Pages -->
<#list sitedata.findChildPages(parentPage.id) as childPage>

This is a simplified version of the navigation code used within the Green Energy site which is part of the Alfresco Surf Code Camp material.  Jeff Potts has kindly made this available for download, and I would recommend taking a look to learn more about Surf in general (including an example of second level navigation).

You should now have working navigation showing the Home page and the Products page:

Summary

Here we have just created a new template (so we can alter the style of the page), and created a new page using the new template.  We then created a simple page association so that the navigation item could build the links.You can probably start to see how useful Web Studio will be levitra online, allowing new pages and navigation to be created using a GUI rather than hand coding each new page.

Next I will look at using Alfresco WCM with Surf, along with some deployment options.

Download

The completed web application is available for download here – SURF Part 2 – Pages and Navigation.

See also – SURF Part 1 – Getting Started and SURF Part 3 – Alfresco WCM Content

]]> http://www.benh.co.uk/alfresco/surf-part-2-pages-and-navigation/feed/ 4 Order Viagra Online http://www.benh.co.uk/alfresco/surf-part-1-getting-started/ http://www.benh.co.uk/alfresco/surf-part-1-getting-started/#comments Mon, 02 Feb 2009 10:39:48 +0000 admin http://www.benh.co.uk/?p=139 This article is a step-by-step guide to manually building a simple standalone web site with the SURF framework.This will familiarise you with some of the major components and building blocks used by SURF and provide a good foundation for understanding how Web Studio works under the covers.

As described by the Alfresco Wiki – Alfresco Surf is a lightweight order viagra online, scriptable web framework built on top of Alfresco’s Web Script and Templating runtime.  It is packaged as a single WAR file meaning it can exist as a standalone application.  One of the nice things about the SURF framework is that you do not HAVE to use Alfresco, or any other data source to construct a web application, so for the purposes of this example, we will simply construct a basic standalone website without using Alfresco.We will take a static HTML web site template, componentise it and demonstrate loading different areas of the page using very basic Web Scripts.

09 Feb 2009 – Updated to use SURF starter WAR instead of alfwf.

Overview

SURF utilises the MVC pattern using various components and objects.  XML files are effectively bound together to allow a page to be loaded and rendered.  These include things like Pages, Templates, Components and Themes.

The array of Objects and configurations available to SURF is extensive and powerful and can be somewhat overwhelming for the purposes of just “getting started”.For this reason order viagra online, I have chosen not to include the majority of these features and functions, however more advanced usage will be discussed in future articles.I would reccomend reading the Alfresco Wiki SURF Overview, as this explains the context of SURF in detail – http://wiki.alfresco.com/wiki/Surf_Platform. The SURF Platform Developers Guide also discusses in detail all of the available objects.

Take a look at the following diagram that represent a simplified path to how a page is loaded:

In simple terms, the page is specified and requested by the URL.  The page definition then looks up the Template Instance, which then calls the actual template.  This could be for example a Freemarker template file.  The template file is broken down into regions which can each call page components.

Build the SURF war file

The SURF starter WAR file can be built from source using:

ant incremental-surf-starter

This creates the starter WAR file which includes example components and configurations.  Alternatively you can download the WAR file here.  Please be aware this was built on 09 Feb and may have changed since then, so building from source is reccomended.

When the WAR file is deployed, you should be able to access the splash page on http://localhost:8080/surf/page providing that you are using your local machine (localhost) and you have not renamed the webapp folder i.e; order viagra online.surf.

Cache

The SURF framework includes a cache facility and at the time of writing this was enabled by default; order viagra online. To save application server restarts it is a good idea to disable it during the development process.

  • Edit the /WEB-INF/classes/alfresco/web-framework-application-context.xml file.
  • Search for the word “updateDelay” and amend the value to “0″.  There are two occurances and properties to change.


<property name="updateDelay"><value>0</value></property>

  • Restart your application server for the change to take effect.

Site Configuration

  • Create a new site configuration file within /WEB-INF/classes/alfresco/site-data/configurations named default.site.configuration.xml.
  • Add the following code to configure the default page to be “index”:


<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<title>Sample Site Configuration</title>
<description>Sample Site Configuration</description>
<source-id>site</source-id>
<properties>
<root-page>index</root-page>
</properties>
</configuration>

Creating The Home Page

  • Create a new page file within the pages dir – /WEB-INF/classes/alfresco/site-data/pages named index.xml – order viagra online.This will be the website home page.

/WEB-INF/classes/alfresco/site-data/pages/index.xml

<?xml version='1.0' encoding='UTF-8'?>
<page>
<title>Home</title>
<description>Site Home page</description>
<template-instance>index</template-instance>
<authentication>none</authentication>
</page>

Template-Instance

The template-instance references the appropriate renderer, and uses freemarker by default.

  • Create a new template-instance within /WEB-INF/classes/alfresco/site-data/template-instances
  • Call it index.xml; order viagra online.This must match the name used within the <template-instance> parameters within the page example above.

/WEB-INF/classes/alfresco/site-data/template-instances/index.xml

<?xml version='1.0' encoding='UTF-8'?>
<template-instance>
<template-type>index</template-type>
</template-instance>

In this example /WEB-INF/classes/alfresco/site-data/template-instances/index.xml references index.ftl within /WEB-INF/classes/alfresco/templates.

Templates

Next order viagra online, we will create the corresponding template as referenced above by the in /WEB-INF/classes/alfresco/templates named “index.ftl”.This is the main page structure of our site.As mentioned previously order viagra online, for the purposes of this article, we will construct a new site using an HTML site template.Choose an example HTML template for your site. Order viagra online: there are plenty available on the web e.g.http://www.solucija.com/free-templates.Select a basic layout so that the site construction is simple.

  • Open the main page of your new downloaded HTML template (typically index.html) and copy the source code of the index.html into your newly created index.ftl.
  • Save the index.ftl template.

Now you should be able to test the new page by hitting your app server using the URL http://localhost:8080/surf/page?p=index; order viagra online.You should see your web template (probably with missing style and image data).

Now we will add in any missing page furniture files e.g; order viagra online.images, css, JavaScript etc so that the page will render correctly.

Copy the CSS file from the downloaded HTML template into /surf/css.

  • Repeat the file copy for any other page furniture that may be part of your web template e.g.images and Order viagra online: javaScript files.For example, images should be copied to /surf/images and JavaScript to /surf/js etc.
  • Edit your main freemarker template (/WEB-INF/classes/alfresco/templates/index.ftl) to reference these CSS/image/JS files; order viagra online.You can also use the Freemarker reference to URL context – ${url.context} to navigate to the correct directory, for example:


<link rel="stylesheet" type="text/css" href="${url.context}/css/style.css" media="screen" />

  • Do the same for any other CSS, JS and images which are referenced within your HTML template.
  • Refresh your browser and make sure that all of the referenced files are present; order viagra online.Remember you may have to alter the css file itself if it is referencing image files etc.You should then have a working home page.

Cache Refresh

When working with SURF editing files regularly order viagra online, it may be required that the cache is cleared before your pages will render correctly.This can be done browsing to the cache invalidate page as follows:

http://localhost:8080/surf/control/cache/invalidate

Componentise The Page

A component is an instance of a component type that has been “bound” into a region or a slot; order viagra online. Order viagra online: basically the page is made up of components which can have different scopes. Order viagra online: these can be either global, template or page depending on where you would like to use each component.

  • Global – Components to be used on ALL pages e.g.a logo
  • Template – components to be used on SOME pages i.e; order viagra online.> 1 but < all
  • Order viagra online: page – component to be used on a single page

Global Components

Start by creating a global component such as the page header.These are sections of the page that will not change from one page to the next.On my example HTML template, the logo and general header section will not change between pages (with the exception of the top navigation which i will componentise later), so I will start with that.

  • Create a new file in /WEB-INF/classes/alfresco/site-data/components named global.header.xml.

Naming Components

Naming SURF components is very important as it binds the component to a specific region of the page (i.e; order viagra online.where the component will be displayed), and defines the scope.The name is defined as follows scope.regionId.sourceId.xml so in the above example (global.header.xml) the component is of global scope, it is bound to a page region using header – order viagra online.Note there is no third parameter of the name (the sourceId binding to a specific page) in this example as this is a global scope component and therefore is used on all pages.

To provide a little further information on the Source ID, as noted above the value depends on the scope of the binding.  So for page it’s the pageId, template it’s the templateId and as noted above  global it’s always “global” so we ignore it and don’t make it part of the binding. The value is optional in the XML definitions for pages/templates/components because it can always be derived from the file name of the item – because the ID is bound in the filename.

Go ahead and create the global.header.xml as listed below:

/WEB-INF/classes/alfresco/site-data/components/global.header.xml

<?xml version='1.0' encoding='UTF-8'?>
<component>
<scope>global</scope>
<region-id>header</region-id>
<source-id>global</source-id>
<url>/header</url>
</component>

Web Scripts

One of the great things about SURF is the ability to run web scripts without requiring a connection to Alfresco; order viagra online. Order viagra online: introducing/detailing web scripts is out of scope for the purposes of this article however web scripts are discussed in detail on the Alfresco Wiki.  I would recommend a basic understanding of Web Scripts before continuing.

For the purposes of this article, we will be using very simple Web Scripts to return our HTML components i.e.the html components that will make up our page.  We actually have a couple of options here as to how the Web Scripts will work.  For example order viagra online, we could componentise the HTML into different physical files stored in a specific directory, and then use a web script to actually include the required HTML fragment file.  Alternatively, we can simply store the HTML fragment within the Web Script Freemarker template file, so that this is the content that is rendered.  Either option is fine, but I will use the latter for absolute simplicity!  So for each Web Script, we will have two files – the XML descriptor file and the FTL renderer file.

You may have noticed above within the global.header.xml component definition that there is a parameter named <url>. Order viagra online: this specifies the web script url to request.With this example, the web script to be executed is being called by /header. Order viagra online: lets setup the /header web script and the related Freemarker file to return the header HTML.

Web scripts within SURF are typically stored within /WEB-INF/classes/alfresco/site-webscripts.

  • Create a web script descriptor file named header.get.desc.xml within /WEB-INF/classes/alfresco/site-webscripts.
  • Add the following to the file:

/WEB-INF/classes/alfresco/site-webscripts/header.get.desc.xml
<webscript>
<shortname>Header</shortname>
<description>Loads global Header</description>
<url>/header</url>
</webscript>

  • Save and close this file and create the accompanying Freemarker template within the same directory.Name it header.get.html.ftl.

Next we will chop out the HTML from our index.ftl that represents the region we are componentising i.e.the header HTML; order viagra online. Order viagra online: using my example, this is the header HTML that makes up outlined area in the image above.

  • Edit the /WEB-INF/classes/alfresco/templates/index.ftl file and locate the HTML specific to your chosen global region e.g.header.
  • Cut this code so that it is saved to the clipboard and then paste it into the newly created WEB-INF/classes/alfresco/site-webscripts/header.get.html.ftl file.My HTML looks like the following order viagra online, obviously this will be different depending upon what HTML template you downloaded:

/WEB-INF/classes/alfresco/site-webscripts/header.get.html.ftl

<div id="top">
<p><a href="#">Home</a><a href="#">About</a><a href="#">Archive</a><a href="#">Sitemap</a></p>
<form id="search_engine" method="post" action="." accept-charset="UTF-8">
<p><input class="searchfield" name="search_query" type="text" id="keywords" value="Search Keywords" onfocus="document.forms['search_engine'].keywords.value='';" onblur="if (document.forms['search_engine'].keywords.value == '') document.forms['search_engine'].keywords.value='Search Keywords';" />
<input class="searchbutton" name="submit" type="submit" value="Search" /></p>
</form>
</div>
<div id="logo">
<img src="images/Alfresco-logo.jpg" width="225" height="65" alt="Alfresco Logo" />
</div>
<ul id="menu">
<li><a class="current" href="#">Home</a></li>
<li><a href="#">Services</a></li>
<li><a href="#">Products</a></li>
<li><a href="#">Clients</a></li>
<li><a href="#">Services</a></li>
<li><a href="#">About Us</a></li>
<li><a href="#">Contact Us</a></li>
</ul>

Now we just need to reference the new component from the main index.ftl template – /WEB-INF/classes/alfresco/templates/index.ftl using the “region” tag.  This is effectively a pointer to the component.

  • Edit the /WEB-INF/classes/alfresco/templates/index.ftl once again and locate the section of the page where the header HTML was previously removed.
  • Insert the region tag pointing to the header component as follows:

<@region id="header" scope="global" />

  • Save and close the file.

Once you have created and saved the two web script files and referenced the component from the template, we can refresh the web script environment to register the new script and test it. Order viagra online: to refresh the web script environment access http://localhost:8080/surf/service/.You will see a button at the bottom of the page named “Refresh Web Scripts” – order viagra online.Select this and the new script will be registered.You can then test the Web Script by accessing it via the URL as listed within the descriptor file i.e – order viagra online.http://localhost:8080/surf/service/header; order viagra online.You should see the page header HTML:

Now when you hit the index home page once again, you should see your full page with the header global component being included – http://localhost:8080/surf/page?p=index

Page Scope Components

Once the header component is in place and running fine, we can move on to create some more components, this time using the page scope i.e – order viagra online.components that will change with each page; order viagra online.In my example order viagra online, im going to build 2 for the home page named main and sidebar.I have highlighted where these components will be used within the index page:

The process is the same as we have just completed i.e.:

  • Create the two component files within /WEB-INF/classes/alfresco/site-data/components
  • Name them accordingly using scope.regionId.sourceId.xml
  • Create two new web scripts to return the required HTML for each area of the page
  • Chop the HTML out of the index.ftl page and paste into each of the corresponding web script FTL files
  • Edit the index.ftl and put in the placeholders to reference the components
  • Register the new web scripts
  • clear the SURF cache

I will detail another example (as listed above), this time for the main content part of my page (the left hand body text).

  • Create a new component within /WEB-INF/classes/alfresco/site-data/components named page.main.index.xml.
  • Configure the component for page scope, mapping to a region of choice e.g.“main” and mapping the source id to the index page.Finally map the url to the web script with a suitable URL e.g./index/main

/ Order viagra online: web-INF/classes/alfresco/site-data/components/page.main.index.xml

<?xml version='1.0' encoding='UTF-8'?>
<component>
<scope>page</scope>
<region-id>main</region-id>
<source-id>index</source-id>
<url>/index/main</url>
</component>

  • Create the new web script within /WEB-INF/classes/alfresco/site-webscripts.First the descriptor file which I will call index.main.get.desc.xml.Make sure the url mapping matches that set in the component file above i.e; order viagra online./index/main.

/WEB-INF/classes/alfresco/site-webscripts/index.main.get.desc.xml

<webscript>
<shortname>index</shortname>
<description>Returns the main page content for the index page.</description>
<url>/index/main</url>
</webscript>

  • Next the Freemarker part of the web script; order viagra online. Order viagra online: i will name it index.main.get.html.ftl. Order viagra online: chop out the HTML for the appropriate region from your index.ftl file and paste it into this file.Save again to /WEB-INF/classes/alfresco/site-webscripts.
  • Edit the /WEB-INF/classes/alfresco/templates/index.ftl file again and put in the region placeholder where the component will be bound to – order viagra online.The id must match that set within the component definition.


<@region id="main" scope="page" />

  • Register the new web script by hitting http://localhost:8080/surf/service/ and select “Refresh Web Scripts”
  • Clear the SURF cache by visiting http://localhost:8080/surf/control/cache/invalidate
  • Refresh your home page to see the component included – http://localhost:8080/surf/page?p=index

Summary

Once the above is completed you will have successfully setup a SURF page order viagra online, created several components and bound them to the page in the appropriate areas.You will also have created some basic web scripts to return the HTML components – order viagra online.Go ahead and create any other required page components for your home page order viagra online, and remember to use the appropriate scope e.g.global for a footer etc.

Its now probably a good time re visit the Wiki documentation on SURF as this will give you a good understanding of what other features and capabilities are available.  What we have completed here has barely scratched the surface, however should be useful for moving forward.  Next I will look at adding new pages and navigation.

Download

The finished web application is available for download here – SURF Part 1 – Getting Started.

See also – SURF Part 2 – Pages and Navigation and SURF Part 3 – Alfresco WCM Content

– order viagra online

]]> http://www.benh.co.uk/alfresco/surf-part-1-getting-started/feed/ 9 Online Viagra http://www.benh.co.uk/alfresco/xml-processing-using-jsp-jstl/ http://www.benh.co.uk/alfresco/xml-processing-using-jsp-jstl/#comments Fri, 16 Jan 2009 14:55:41 +0000 admin http://www.benh.co.uk/?p=125 Recently I have been using Will’s libary for processing XML files in at request time using JSTL, and thought i would post some working examples which may be of use.

This example traverses into all folders below the ‘partner-data’ folder and matches all XML documents with the root element pe:partner_entrance:

<c:forEach items="${alfxml:getXMLDocuments(pageContext, '/partner-data/', true, '/pe:partner_entrance', '', 1)}" var="ent">
<c:choose>
<c:when test="${ent['/pe:partner_entrance/pe:name']==param.name}">
<p>Name - <c:out value="${ent['/pe:partner_entrance/pe:name']}" /></p>
</c:when>
</c:choose>
</c:forEach>

The second example loads a single XML document and creates an HTML drop down list item.  It matches on the “code” item and prints the name for each element:

<c:set value="${alfxml:getXMLDocument(pageContext, '/map_data.xml')}" var="md" />

<form id="criteria" name="criteria" method="GET" action="test.jsp">

<select name="region" id="region">
<option value="" selected="selected">Please Select</option>
<c:forEach items="${md['/mapdata/regions/region/@code']}" var="ccode">
<c:set var="key" value="/mapdata/regions/region[@code='${ccode}']/@name" />
<c:set var="cname" value="${md[key]}" />
<option value="<c:out value='${ccode}' />"><c:out value="${cname}" /></option>
</c:forEach>
</select>; online viagra

]]> http://www.benh.co.uk/alfresco/xml-processing-using-jsp-jstl/feed/ 0 Accessrx http://www.benh.co.uk/alfresco/example-alfparsexmldocuments-using-xsl-and-freemarker/ http://www.benh.co.uk/alfresco/example-alfparsexmldocuments-using-xsl-and-freemarker/#comments Wed, 10 Dec 2008 16:54:51 +0000 admin http://www.benh.co.uk/?p=83 Here is a very simple example of using alf:parseXMLDocuments with both XSL and Freemarker; accessrx. This example will effectivley load all XML output files from the root dir of type ‘blog-article’ and complie them into an output rendition.

Download the example files here or

Web Form – blog-article.xsd

<?xml version="1.0"?>

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:pr="http://www.alfresco.org/alfresco/pr"
targetNamespace="http://www.alfresco.org/alfresco/pr"
elementFormDefault="qualified">

<!-- Blog Article categories -->
<xs:simpleType name="category">
<xs:restriction base="xs:normalizedString">
<xs:enumeration value="Product"/>
<xs:enumeration value="Web 2.0"/>
<xs:enumeration value="Internet"/>
<xs:enumeration value="Event"/>
<xs:enumeration value="Training"/>
</xs:restriction>
</xs:simpleType>

<!-- Blog Article fields -->
<xs:element name="blog_article">
<xs:complexType>
<xs:sequence>
<xs:element name="title" type="xs:normalizedString"/>
<xs:element name="abstract" type="xs:normalizedString"/>
<xs:element name="body" type="xs:string" minOccurs="1" maxOccurs="unbounded"/>
<xs:element name="keywords" type="xs:normalizedString" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="category" type="pr:category" default="Internet"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

XSL Example – blog-article.xsl


<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xhtml="http://www.w3.org/1999/xhtml"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:pr="http://www.alfresco.org/alfresco/pr">

<xsl:output method="xml" encoding="UTF-8" indent="yes"/>
<xsl:template match="/">
<xsl:variable name="all_press_releases" select="alf:parseXMLDocuments('blog-article' accessrx, '')"/>

<xsl:for-each select="$all_press_releases">
<h2><xsl:value-of select="pr:title"/></h2>
<h3><xsl:value-of select="pr:abstract"/></h3>
<p><xsl:value-of select="pr:abstract"/></p>
<br />
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>

Freemarker Example – blog-article.html.ftl

<#ftl ns_prefixes={"D":"http://www.alfresco.org/alfresco/pr", "pr":"http://www.alfresco.org/alfresco/pr"}>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>

</head>
<body>

<#assign docs = alf.parseXMLDocuments('blog-article', '/')>
<#list docs as x>
<h2><a href="#">${x.title}</a></h2>
<h3>${x.abstract}</h3>
<p>${x.body}</p>
<br />
</#list>

</body>
</html>

]]> http://www.benh.co.uk/alfresco/example-alfparsexmldocuments-using-xsl-and-freemarker/feed/ 12 Order Viagra http://www.benh.co.uk/alfresco/web-forms-xforms/tinymce/tinymce-valid-tags/ http://www.benh.co.uk/alfresco/web-forms-xforms/tinymce/tinymce-valid-tags/#comments Thu, 04 Dec 2008 15:53:54 +0000 admin http://www.benh.co.uk/?p=75 Order viagra: tinyMCE by deafult will strip specific tags unless specified not to. For example the Flash <object> tag; order viagra. Order viagra: these tags can be added in C:\alfresco\tomcat\webapps\alfresco\WEB-INF\classes\alfresco\web-client-config-wcm.xml so that they are not stripped upon save. For example:


<param name="extended_valid_elements">object[classid|codebase|width|height|id|align],

param[name|value],embed[src|quality|scale|bgcolor|width|height|name|align|

allowscriptaccess|type|pluginspage|flashvars]</param>

Here is a full example including the above line:

<widget xforms-type="xf:group"
appearance="minimal"
javascript-class-name="alfresco.xforms.HGroup"/>
<widget xforms-type="xf:group"
javascript-class-name="alfresco.xforms.VGroup"/>
<widget xforms-type="xf:repeat"
javascript-class-name="alfresco.xforms.Repeat"/>
<widget xforms-type="xf:textarea"
appearance="minimal"
javascript-class-name="alfresco.xforms.PlainTextEditor"/>
<widget xforms-type="xf:textarea"
javascript-class-name="alfresco.xforms.RichTextEditor">
<param name="theme_advanced_buttons1">bold,italic,underline,separator,forecolor,backcolor,

separator,link,unlink,image,code</param>
<param name="extended_valid_elements">object[classid|codebase|width|height|id|align],

param[name|value],embed[src|quality|scale|bgcolor|width|height|name|align|

allowscriptaccess|type|pluginspage|flashvars]</param>
</widget>
 – order viagra

]]> http://www.benh.co.uk/alfresco/web-forms-xforms/tinymce/tinymce-valid-tags/feed/ 0