Skip to content
Themes from Start Bootstrap (https://startbootstrap.com) as a UIs for Yii 2 Framework (http://www.yiiframework.com).
Branch: master
Clone or download
Latest commit ef60c94 Apr 15, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets v2.17.0 Apr 13, 2018
views v2.16.2 Jun 20, 2017
z.gitignore v2.16.2 Jun 20, 2017
LICENSE-MIT.md v0.12.0 Feb 20, 2017
README.md v2.16.3-beta Apr 15, 2018
composer.json v2.16.3-beta Apr 15, 2018

README.md

P2 Start Bootstrap Themes v2.16.3-beta

License Total Downloads Monthly Downloads Latest Stable Version Latest Unstable Version


Themes from Start Bootstrap as a UIs for Yii 2 Framework.

These themes contain AssetBundles, Views, and Widgets to render the Start Bootstrap themes as Yii 2 themes.

P2 Start Bootstrap Themes declares p2made/yii2-p2y2-things and p2made/yii2-p2y2-things-demo as dependancies.

¡¡ IMPORTANT !!

Version 2.0.0 of all my Yii2 add-ons marks a breaking change where I've shortened my namespaces. p2made\rest\of\namespace is now p2m\rest\of\namespace.

Installation

The preferred way to install P2 Start Bootstrap Themes is through composer. Depending on your composer installation, run one of the following commands:

composer require --prefer-dist p2made/yii2-startbootstrap-themes "^2.16"

or

php composer.phar require --prefer-dist p2made/yii2-startbootstrap-themes "^2.16"

Alternatively add:

	"p2made/yii2-startbootstrap-themes": "^2.16"

to the requires section of your composer.json file & P2 Start Bootstrap Themes will be installed next time you run composer update.

The files are installed via Yii's recommended usage of the fxp/composer-asset-plugin.

Quick Start

Once the extension is installed, you can have a preview by reconfiguring the path mappings of the view component with one of @app/views lines:

	'components' => [
		'view' => [
			'theme' => [
				'pathMap' => [
					'@app/views' => '@vendor/p2made/yii2-startbootstrap-themes/views/agency',
					'@app/views' => '@vendor/p2made/yii2-startbootstrap-themes/views/business-casual',
					'@app/views' => '@vendor/p2made/yii2-startbootstrap-themes/views/business-frontpage',
					'@app/views' => '@vendor/p2made/yii2-startbootstrap-themes/views/creative',
					'@app/views' => '@vendor/p2made/yii2-startbootstrap-themes/views/freelancer',
					'@app/views' => '@vendor/p2made/yii2-startbootstrap-themes/views/grayscale',
					'@app/views' => '@vendor/p2made/yii2-startbootstrap-themes/views/heroic-features',
					'@app/views' => '@vendor/p2made/yii2-startbootstrap-themes/views/landing-page',
					'@app/views' => '@vendor/p2made/yii2-startbootstrap-themes/views/modern-business',
					'@app/views' => '@vendor/p2made/yii2-startbootstrap-themes/views/new-age',
					'@app/views' => '@vendor/p2made/yii2-startbootstrap-themes/views/one-page-wonder',
					'@app/views' => '@vendor/p2made/yii2-startbootstrap-themes/views/stylish-portfolio',
				],
			],
		],
	],

This asset bundle provides sample files for layout and view (see folder views/), they are not meant to be customized directly in the vendor/ folder. If you do that, your changes will be lost next time you run composer update.

Therefore it is recommended to copy the views into your application and adjust them to your needs.

To view pages in site/pages/ you need to modify actions() in the SiteController:

	public function actions()
	{
		return [
			...
			'page' => [
				'class' => 'yii\web\ViewAction',
			],
		];
	}

P2 Start Bootstrap Themes uses P2Y2Things which requires some Yii 2 assets to be nullified to avoid conflicts through double loading. Modify common/config/main.php with...

	'components' => [
		'assetManager' => [
			'bundles' => [
				'yii\web\JqueryAsset' => [
					'sourcePath' => null, 'js' => [],
				],
				'yii\bootstrap\BootstrapAsset' => [
					'sourcePath' => null, 'css' => [],
				],
				'yii\bootstrap\BootstrapPluginAsset' => [
					'sourcePath' => null, 'js' => [],
				],
				'yii\jui\JuiAsset' => [
					'sourcePath' => null, 'css' => [], 'js' => [],
				],
				'\rmrevin\yii\fontawesome\AssetBundle' => [
					'sourcePath' => null, 'css' => [],
				],
			],
		],
		...
	],

Customization

  • Copy files from vendor/p2made/yii2-startbootstrap-themes/views-preview/_your_choice_of_theme_ to @app/views.
  • Remove the custom view configuration from your application by deleting the path mappings, if you have made them before.
  • Edit your views adhering to the example views.
You can’t perform that action at this time.