2013-01-16: Just released the first version of the connector for our Hippo enterprise offer. This project will not be updated anymore. Please, fell free to contect me for more information.
The aim of this project is to create a bridge between Hippo CMS and Konakart.
Don't set to true subjectbasedsession, users are not saved in hippo.
Please install the community version or the enterprise version.
Only community features are available.
In order to process with the next step, you need to define the KONAKART_HOME variable.
i.e.: KONAKART_HOME='C:\app\konakart\KonaKart-6.3.0.0\'
Konakart uses ant to build the entire project. The librairies are not available on any Maven repository. The project Konakart Dependency has been created to import into your local m2 repo the librairies.
The following steps need to be executed:
- Clone the project
- cd konakart-dependency
- run mvn install
- Create a new project using the latest version of the artifact. Currently tested with the version 1.05.06
- Add the following conf
<properties>
<mysql.version>5.1.18</mysql.version>
<hippo-konakart.version>1.00.04</hippo-konakart.version>
</properties>
<dependencyManagement>
...
<dependency>
<groupId>org.onehippo.forge.konakart</groupId>
<artifactId>hippo-addon-konakart-cms</artifactId>
<version>${hippo-konakart.version}</version>
</dependency>
<dependency>
<groupId>org.onehippo.forge.konakart</groupId>
<artifactId>hippo-addon-konakart-repository</artifactId>
<version>${hippo-konakart.version}</version>
</dependency>
<dependency>
<groupId>org.onehippo.forge.konakart</groupId>
<artifactId>hippo-addon-konakart-hstclient</artifactId>
<version>${hippo-konakart.version}</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>${mysql.version}</version>
</dependency>
...
</dependencyManagement>
<profile>
<id>cargo.run</id>
<dependencies>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>${mysql.version}</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
...
<configuration>
<container>
<dependencies>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
</dependency>
</dependencies>
...
</container>
</profile>- Add a copy of the konakart.properties and the konakart_app.properties files under src/main/resources
- Add the following lines into the pom.xml file
<dependency>
<groupId>org.onehippo.forge.konakart</groupId>
<artifactId>hippo-addon-konakart-cms</artifactId>
</dependency>
<dependency>
<groupId>org.onehippo.forge.konakart</groupId>
<artifactId>hippo-addon-konakart-repository</artifactId>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
</dependency>- Add a copy of the konakart.properties, the konakart_app.properties and the konakart_velocity.properties files under src/main/resources
- Add the following lines into the pom.xml file
<dependency>
<groupId>org.onehippo.forge.konakart</groupId>
<artifactId>hippo-addon-konakart-hstclient</artifactId>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
</dependency>- Create a new file named //konakart-hst-configuration.xml// under resources/META-INF/hst-assembly/overrides to add the konakart Valve
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd">
<import resource="classpath:/org/onehippo/forge/konakart/hst/konakart-hst-configuration.xml"/>
</beans>- Add in the web.xml of your site the following value to context parameter hst-beans-annotated-classes (note that the values are comma separated):
<context-param>
<param-name>hst-beans-annotated-classes</param-name>
<param-value>
classpath*:org/onehippo/forge/konakart/hst/beans/**/*.class
</param-value>
</context-param>- Add the following database configuration to the context.xml file. You will add the connection to the Konakart DB previously created.
You need to change the username, password as well as the database name.
<!-- Hippo Konakart configuration-->
<Resource
name="jdbc/konakart" auth="Container" type="javax.sql.DataSource"
maxActive="20" maxIdle="10" minIdle="2" initialSize="2" maxWait="10000"
testOnBorrow="true" validationQuery="select 1 from dual"
poolPreparedStatements="true"
username="TBD" password="TBD"
driverClassName="com.mysql.jdbc.Driver"
url="jdbc:mysql://localhost:3306/TBD?zeroDateTimeBehavior=convertToNull&autoReconnect=true&characterEncoding=utf8" />
The authentication process is based on spring security.
- You need to create a new file under src/main/webapp/WEB-INF/applicationContext-security.xml. Take the example
- You need to modify the web.xml. Take the example
- In order to synchronize the product between Konakart and Hippo, you need to update the available locale within Konakart. By default, Konakart installs the following locales:
- Deutch - de_DE
- English - en_GB
- Español - es_ES
- Português - pt_BR
The English locale must be updated from en_GB to en_US.
The synchronization is started after log-in to the CMS. A service has been created to handle this task.
- You need to update the following node with your needs. "/konakart:konakart/konakart:stores/store1"
- Update contentroot (i.e. /content/documents/gettingstarted)
- Update galleryroot (i.e. /content/gallery/gettingstarted)
- Add the locale property to map with the konakart locale