manuscle/sxbootstrap2

This package is abandoned and no longer maintained. No replacement package was suggested.

A twitter bootstrap module for ZF2 & TWBS 2.3.2 based on spoonx/SxBootstrap

Maintainers

Details

github.com/e-belair/SxBootstrap2

Homepage

Source

Issues

Installs: 12

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

dev-master 2018-01-05 12:13 UTC

Requires

Requires (Dev)

Suggests

Replaces

BSD-2-Clause 644cb702cd6de9fcac71c3db220912c570b7775b

bootstrapzf2twitterZend Frameworkassetmanager

This package is not auto-updated.

Last update: 2022-02-01 13:11:40 UTC

README

This is a copy of SxBootstrap from https://github.com/SpoonX/SxBootstrap

Changes made on this repos:

No change at the moment

SxBootstrap2

This version has revisited the Form implementation, and is now easier to use than ever!

This module supplies view helpers to make it easy to work with twitter bootstrap. Optionally, this module also allows you to build, cache, modify and extend twitter bootstrap using the AssetManager module.

Installation ViewHelpers

How?

Add the requirement to your composer.json file

./composer.phar require spoonx/sxbootstrap
# When asked for a version, type: "2.*"

Installation Font Awesome

How?

  1. Add the dependency to your composer.json file:

    ./composer.phar require fortawesome/font-awesome
# When asked for a version, type: "3.*"

  2. Enable the use of Font Awesome by adding the following in config/autoload/sxbootstrap.local.php:

    <?php
return array(
    'twitter_bootstrap' => array(
        'use_font_awesome' => true,
    ),
);

Installation renderer (recommended)

How?

  1. Add the dependencies to your composer.less file:

    ./composer.phar require rwoverdijk/assetmanager twbs/bootstrap
# When asked for a version, type: "1.*" for assetmanager and "2.*" for bootstrap.

  2. Enable AssetManager and SxBootstrap in your application.config.php config file.

  3. Install less...

    a) Via NPM/Node.js (recommended method):

    1. Install npm/node.js. [Instructions](https://github.com/joyent/node/wiki/Installing-Node.js-via-package-manager) can be found here.
2. To Install lessc, open up your command line, and navigate to your project (`cd /path/to/my/project`).
3. Once you get there, run the following command: `npm install less .` (including the dot).

    b) Via lessphp (Advised against):

    **Add the requirement**

```bash
./composer.phar require leafo/lessphp
# When asked for a version, type: "0.*"
```

Then add the following config to your application's module.config.php:

```php
'twitter_bootstrap' => array(
    'use_lessphp' => true,
),
```

  4. Configure the filter to get it working. (This only applies to you if your using node.js and the binary is not in /usr/bin/node, or your node paths are not the default, so you've ignored my advice in step 3a.)

  5. Take a look at the wiki for examples and other information to get started. Specifically the part on how to configure the filter to get it working (bottom of the page)

Okay... Why?

The renderer has a lot of advantages.

  • Allows easy customization
  • Allows you to extend (use mixins and variables in your own less files!)
  • Prevents having to manually manage assets
  • Allows toggling components, and plugins to include (minimizing file size by not included what you do not need).
  • And more.

Features

  • Simple awesome forms
  • NEW Optional Font Awesome integration
  • NEW Add load paths
  • NEW Add custom components
  • Customizable (variables, components, plugins)
  • Works with AssetManager
  • Plenty of ViewHelpers
  • Extendable (run your own less files from bootstrap context to share mixins and variables)
  • Tested with twitter bootstrap 2.3+ (older versions will probably work, too)
  • You can optionally use lessphp (not recommended)

Usage

Check out the config/sxbootstrap.local.php.dist file in vendor/spoonx/sxbootstrap/config for the configuration options, and info. Also, please check out the wiki.

Questions / support

If you're having trouble with the module there are a couple of resources that might be of help.