1.1 What is WallRide?

WallRide is a multilingual easy-to-customize open source CMS made by Java, using Spring Framework, Hibernate and Thymeleaf.
WallRide focuses on sophisticated UI, simple and clean source code and easy deploy to AWS BeansTalk(of course other servlet containers)
We hope this CMS is loved by many developers of principles all over the world.

1.2 What is the strong point?

1. Multilingual CMS.

2. Full-text search.

3. Affinity for AWS.

2.1 Installation requirements

• Java8 or higher
• Database (MySQL or PostgreSQL)

2.2 Preparation

1. Create database for WallRide

2. Check out sources

$ git clone git@github.com:tagbangers/wallride.git
$ cd wallride/

3. Create wallride.home

$ mkdir <WALLRIDE_HOME>
$ mkdir <WALLRIDE_HOME>/config
$ cp wallride-core/src/main/resources/application.properties <WALLRIDE_HOME>/config

4. Set application.properties

Configure these properties in application.properties according to your environment.

Edit <WALLRIDE_HOME>/config/application.properties.

Required properties are:

spring.datasource.url
spring.datasource.username
spring.datasource.password
spring.mail.host
spring.mail.port
spring.mail.default-encoding

Now, let’s run the application. You can choose the way to run from the following;

2.3.1 Run from Maven Command Line

1. Execute Command

$ ./mvnw spring-boot:run -Pjar -Drun.jvmArguments="-Dwallride.home=file:<WALLRIDE_HOME>" 

2. Access URL below

http://localhost:8080/_admin/setup

3. See 4.1 Setup

2.3.2 Run Executable jar

1. Execute command

$ ./mvnw package -P jar && JAVA_OPTS="-Dwallride.home=file:<WALLRIDE_HOME>" ./wallride-bootstrap/target/wallride-bootstrap-X.X.X.jar

2. Access URL below

http://localhost:8080/_admin/setup

3. See 4.1 Setup

2.3.3 Run from AWS Elastic Beanstalk

1. Build Project

$ ./mvnw package -P war

the war file will be created in the directory below

./wallride-bootstrap/target/wallride-bootstrap-X.X.X.war

2. Create application.properties in S3

Configure items below in application.properties And set the value of jgroups

jgroups.configurationFile=jgroups-ec2.xml
jgroups.s3.bucket={your-s3-bucket-name}

3. Setup AWS Elastic Beanstalk

Tier: Web Server
Platform: Tomcat

4. Configure Environment properties

Name: wallride.home
Value: s3://<WALLRIDE_HOME>

5. Upload war

6. Access URL below
   http://xxx.elasticbeanstalk.com/_admin/setup

7. See 4.1 Setup

4.1 Setup

After you launch the app, you will see this screen.

This is the basic setting of the new website. You input title, default language, other languages to switch, and first user info.

WallRide is inspired by Wordpress, so if you are familiar with Wordpress you can start WallRide quickly relatively without difficulty. “Article” in WallRide nearly equals to “Post” in Wordpress. (Post whose URL has datetime.) The big difference between WallRide and WordPress is that WallRide has “Categories” and “Tags” for “Page” as well. It’s because we have faced with some situation that we want to group “Articles” and “Pages” by common category or tag.
For example, suppose that you want to make an event introduction page. Usually you start creating explanation of an event with “Page”. But sometimes we want to link latest articles related with the event to it.

5.1 Customize themes

WallRide has original themes for the guest site in it, but you can replace them by putting your sources in wallride.home.

1. HTML

WallRide’s template engine is thymeleaf. If you extend it, please refer to Thymeleaf documentation as well.

Template for guest site

WallRide customizable variables … choto matte kudasai.

#articles

#posts

#pages

2. Resources

Place resource files under “resources” directory in wallride.home. You can refer them from html like this;

<link rel="stylesheet" th:href="@{/resources/css/sticky-footer-navbar.css}" href="#" />
<script th:src="@{/resources/lib/jquery.lazyload.min.js}" src="#"></script>

6.1 Overall architecture

WallRide uses Spring Framework, Hibernate, and Thymeleaf.

6.2 Customize

Thanks to Spring Boot starters which WallRide uses and customizes, it is very easy to customize it with 3 steps.

1. Write pom.xml

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.wallride</groupId>
        <artifactId>wallride-parent</artifactId>
        <version>1.0.0.M18</version>
    </parent>
    <groupId>com.example</groupId>
    <artifactId>example-blog</artifactId>
    <version>1.0.0.RELEASE</version>
    <packaging>jar</packaging>

    <properties>
        <start-class>com.example.Application</start-class>
    </properties>

    <dependencies>
        <!-- MySQL Driver -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.23</version>
        </dependency>
    </dependencies>
</project>

2. Create main class with @SpringBootApplication

@SpringBootApplication
public class Application extends SpringBootServletInitializer  {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

That’s it! Now you can start customize.

3. In case of adding URL

@SpringBootApplication
@WebGuestComponentScan(basePackageClasses = TestController.class)
@WebAdminComponentScan(basePackageClasses = DummyController.class)
public class Application extends SpringBootServletInitializer  {
    //run main class
}

4. In case of overriding existing Controller

5. In case of adding Service

@SpringBootApplication
@ComponentScan(basePackageClasses = DummyService.class)
public class Application extends SpringBootServletInitializer  {
    //run main class
}

6. In case of adding Repository

@SpringBootApplication
@EnableJpaRepositories(basePackageClasses = DummyRepository.class)
public class Application extends SpringBootServletInitializer  {
    //run main class
}

7. In case of adding Entity

@SpringBootApplication
@EntityScan(basePackageClasses = Dummy.class)
public class Application extends SpringBootServletInitializer  {
    //run main class
}

6.3 Entities

ER diagram

6.4 About HA

WallRide enables HA architecture by using infinispan.

For more Details: chotto matte kudasai