No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
phpsass @ b8d0f58
.gitmodules
IjPhpsassPlugin.class.php
README.md
jPhpsass.CSSprepro.php

README.md

What is jPhpsass ?

This project is a plugin for Jelix PHP framework. It allows you to use easily Sass dynamic stylesheet language in Jelix (using phpsass compiler).

This is a plugin of CSSprepro which is itself an htmlresponse plugin for Jelix.

Installation

Under Jelix default configuration, create (if missing) a "CSSprepro" directory in your project's "plugins" directory. Clone this repository in that directory with :

git clone --recursive git@github.com:brice-t/jPhpsass.git

Note that you should have your app plugin directory in your modulesPath (defaultconfig.ini.php or entry point's config.ini.php) to get it working. The value should be at least :

modulesPath="app:modules/"

Usage

When including a CSS file (e.g. with addCSSLink()) you should set 'sass'=>true as a param.

Another way of having a file compiled with Sass is including as file with .scss or .sass extension. You can set expected extensions in the comma-separated value of CSSprepro_jPhpsass_extensions under the jResponseHtml section.

E.g. in your response :

$this->addCSSLink($gJConfig->urlengine['basePath'].'themes/'.$gJConfig->theme.'/Css/style.sass');

or

$this->addCSSLink($gJConfig->urlengine['basePath'].'themes/'.$gJConfig->theme.'/Css/style.sassFile', array( 'sass' => true ));

Your config file must activate jPhpsass plugin :

[jResponseHtml]
plugins=jPhpsass

N.B. : the directories containing Sass files should be writable by your web server ! Indeed, compiled files will be written in that very same directory so that relative urls go on working ...

Config

You can configure jPhpsass's behviour regarding compilation:

[jResponseHtml]
;...
; always|onchange|once
CSSprepro_jPhpsass_compile=always

If CSSprepro_jPhpsass_compile's value is not valid or empty, its default value is onchange.

  • always : compile Sass file on all requests
  • onchange : compile Sass file only if it has changed
  • once : compile Sass file once and never compile it again (until compiled file is removed)