Skip to content

intelliants/subrion-template-cityguide

Repository files navigation

subrion-template-cityguide

Default template for Subrion CMS 4.x with style support for every Subrion plugin and package.

Installation

  1. Download latest release https://github.com/intelliants/subrion-template-cityguide/releases
  2. Unpack contents of archive to [root]/templates folder
  3. Rename subrion-template-cityguide-master to cityguide
  4. Activate template in admin dashboard.

Or you can

cd [root]/templates # where root is the location of subrion core
git clone https://github.com/intelliants/subrion-template-cityguide.git ./cityguide

Voila! Just activate it in your Dashboard / Extensions / Templates

Development

This manual covers development of visual styles. To learn more about Subrion template structure and configuration options, please refer to Subrion Extensions wiki page: URL_TO_SUBRION_WIKI

The CityGuide template is setup to use Gulp to compile LESS (with source maps), run it through AutoPrefixr, optimize images, and syncs changes across local development devices with BrowserSync, with flexibility to add any additional tasks via the Gulpfile. Alternatively, you can use Prepros or whatever else y ou prefer to compile the LESS and manage the JavaScript.

Prerequisites

In root folder of CityGuide template run:

npm i

To install all necessary node modules.

BrowserSync

Before running dev task, be sure to copy config.sample.json and rename it to config.json. Then change server config in config.json file for BrowserSync to work properly. Otherwise BrowserSync won't work.

Tasks

gulp dev

Starts BrowserSync and watches for LESS files. Optimizes images and compiles LESS with SourceMaps.

gulp build

Compiles LESS and optimizes images.

Compiling with GUI tools

If you don't want to use Gulp task-runner to process template files, you can use any GUI compilers like Prepros, Koala or Simpless.

What is important:

  • The main file for compilation is iabootstrap.less. It should be compiled to [root]/templates/cityguide/css/iabootstrap.css

Template styles/elements page

There is a hidden page with all supported elements. You can access it like this:

http://yourdomain.com/?elements

Contributing

Anyone is welcome to contribute! Check out the Contributing Guidelines.