Contao boilerplate with starter theme and build tools.
Contao 3.5 LTS and 4.4 LTS are supported by correspondig GitHub Tags.
- gulp build and server push.
- some preconfiguration of tinyMCE and dcaconfig.php
- Bootrap SASS files in a minimal configuration. Relevant Contao content elements prepared.
- JS bundled with Webpack.
app/js/entry.js
is used as starting point for Webpack.
Output is saved in files/dist/js/
and uploaded to server.
app/sass/styles.scss
is the starting point. Output are saved infiles/dist/css/
- CSS gets autoprefixed, compressed by cssnano, sourcemaped and uploaded to server.
- CSS is based on Bootstrap v4-alpha4.
- Styles for common Contao modules / elements are prepared.
Changes on any files in templates/
are uploaded to server.
The system/
folder contains useful presets.
- TinyMCE Custom configuration.
- Images Shortcut is removed
- Formats is pulled into top level
paste_as_text
is enabled, to remove all formatting on copy & paste
dcaconfig.php
contains presets including a list of all available Conten Elements, that could be disabled, if not needed in the project.- the module
modules/contao-boilerplate
contains some presets
- upload contao as usual
- upload this bundle to root.
you can skip the folders
app/
andbuild
. - install with contao install tool
contao/install.php
. - import Template
website.spq
- create user
contao-mobilecontent
contao-seo-serp-preview
contao-lazy-images
contao-notification_center
contao-m17StickyBEFooter
The folder build/
contains everything necessary for build the app.
globaly install npm & bower
- install npm
curl -L https://npmjs.org/install.sh | sh
- install bower
npm install -g bower
- install bower-installer
npm install -g bower-installer
- goto folder
build/
and install needed node modules
npm install
- install app dependencies
bower-installer
Copy secrets.json.default
to secrets.json
and fill in your FTP credentials.
If FTPS is not supported remove the following lines from the function getFtpConnectionin the
gulpfile.js`.
secure : true,
secureOptions: { rejectUnauthorized: false },
start task runner Gulp
- watch for changes and deploy while developement
gulp
- build and deploy only
make:make
lib | URL |
---|---|
gulp | http://gulpjs.com/ |
gulp-util | https://www.npmjs.com/package/gulp-util |
gulp-sourcemaps | https://www.npmjs.com/package/gulp-sourcemaps |
gulp-sass | https://www.npmjs.com/package/gulp-sass |
gulp-postcss | https://github.com/postcss/gulp-postcss |
autoprefixer | https://github.com/postcss/autoprefixer |
cssnano | http://cssnano.co/ |
webpack | https://webpack.github.io/ |
browserSync | https://www.browsersync.io/ |
gulp-livereload | https://www.npmjs.com/package/gulp-livereload |
vinyl-ftp | https://www.npmjs.com/package/vinyl-ftp |