An open API service indexing awesome lists of open source software.

https://github.com/rayluo/adminlte-web2py

A web2py layout template based on AdminLTE. (NOTE: This repo is now replaced by its successor, the new web2py plugin_adminlte at https://github.com/rayluo/plugin_adminlte )
https://github.com/rayluo/adminlte-web2py

adminlte layout-adminlte web2py

Last synced: about 1 year ago
JSON representation

A web2py layout template based on AdminLTE. (NOTE: This repo is now replaced by its successor, the new web2py plugin_adminlte at https://github.com/rayluo/plugin_adminlte )

Awesome Lists containing this project

README

          

# AdminLTE-web2py: A web2py layout using the AdminLTE template

## Note: We've moved

This repo is now kept as an archive.

It has been reworked since, and the new development is carried on in its successor,
[web2py plugin adminlte](https://github.com/rayluo/plugin_adminlte).
It would be easier to install/use. Please give it a try!

## How to use it

* Create a new web2py app. Let's call it `lte` for this example.
* Open a terminal window and go to the web2py/applications directory. It should look something like this:

````
__init__.pyc adminltest welcome
__init__.py admin examples lte
````

* Change to the `static` directory for the new application (in this case named `lte`)

````
$ cd lte/static
````

### Download AdminLTE straight from Github

* Download the [AdminLTE Dashboard & Control Panel Template](http://almsaeedstudio.com/preview). Assuming
you are still in the `web2py/applications/lte/static` directory, get it from Github like this:

If you don't have Curl yet, get it free from http://curl.haxx.se/download.html.

````
# Copy as a zip file from Github.
# -C means resume transfer if interrupted
# -L means follow any redirects
# -O saves file to the current directory
# -k relaxes security. Hey, it's Github.
$ curl -C - -LOk https://github.com/almasaeed2010/AdminLTE/archive/master.zip
````

#### Warning
AdminLTE carries a ton of demo code. It's a 6MB download.

* Confirm the file `master.zip` has been copied down to your directory:

````
$ ls
403.html 500.html images master.zip
404.html css js
````

* Now extract the .zip archive.

````
$ unzip master
````

This will create a directory called AdminLTE-master:

````
$ ls
403.html 500.html css js
404.html AdminLTE-master images master.zip
````

* You can delete `master.zip` if you wish.

````
$ rm master.zip
````

* Rename the unzipped directory `adminlte`.
To keep with convention and save typing, I simplified the directory name in
the 'layout_adminlte.html' file:

````
$ mv AdminLTE-master adminlte
````

### Look at the demo project and documentation pages

* Try viewing some of the files. Here's how to do it from the command line. Again,
still assuming you're in the `web2py/applications/lte/static` directory.

````
# The two best demos:
$ sudo open adminlte/index.html
$ sudo open adminlte/index2.html

# Show a minimal page--this is a good starting
# point for your own AdminLTE templates.
$ sudo open adminlte/starter.html

# The documentation is pretty damn good
# for an open source freebie.
$ sudo open adminlte/documentation/index.html
````

Or if you have web2py's default Rocket server installed (replace the directory name `lte` with the name of your application):

http://127.0.0.1:8000/adminlte/static/adminlte/index.html

http://127.0.0.1:8000/adminlte/static/adminlte/index2.html

http://127.0.0.1:8000/adminlte/static/adminlte/starter.html

http://127.0.0.1:8000/adminlte/documentation/index.html

## Get layout_adminlte.html from Github

Go to the `../views` directory, then download the new layout file:

````
$ cd ../views
curl -C - -LOk https://raw.githubusercontent.com/tomcam/AdminLTE-web2py/master/layout_adminlte.html
````

## Use the new layout in a web2py project

* Fire up web2py and edit the view file `default/index.html`. Find this line (it's usually the first):

````
{{extend 'layout.html'}}
````

* Replace `layout.html` with `layout_adminlte.html` so it now looks like this:

````
{{extend 'layout_adminlte.html'}}
````

OK. Run your app and you'll see a stunningly new look.