djbarnes / winelist Goto Github PK

Winelist is a small laravel 4.0.* application that shows some of the basic functionality that can be accomplished with Laravel. The project was the result of a small set of classes I taught on the framework. It allowed students to understand MVC, and get a feel for how the components fit together.

A demo of this application can be seen at the following Link. The application is wired up to an actual database, and although I don't mind you playing around to see how the application functions, please don't be a troll. Otherwise I will be forced to remove the database component and alter the behavior of the application to something different than what the code reflects.

The project uses Laravel 4.0.*. No other libraries were used. The main focus was on vanila laravel.

This version of the CAEWeb application uses the Eloquent driver, which is the Laravel default. Navigating to the site sends users to the login page. All routes require the user to be logged in before they can access them. The default username and password that is setup by the database seeder is:

UN:admin

PW:laravel4

After logging in, a user is presented with the wine list. From here a user can filter the results, edit and entry, and add a new entry. Filtering is done by using the filter box at the top of the page. Autocomplete using jqueryUI is attached to every textbox for the filter. Clicking a row in the list of items will take the user to an edit page for the item. Clicking the add new button will take the user to page that looks similar to the edit page, but with no fields filled out.

Clicking on a row in the wine list takes the user to a detailed page that allows for the alteration of the fields of the item. There is also a save button that will save the item to the database. I was going to add a delete button to this page as well so that an item could be deleted, but we did not have time to add it. Something for a future release.

Clicking add new presents the user with a form to fill in the Item Number, Name, Slot Location, and Pack Size. Once filled out clicking the Add button will add the new item to the database.

Clicking this button will cause the logged in user to become logged out.

To install this application you can folllow the following instructions:

1. clone or download the repository.
2. Make sure that the web root for your domain points to the public folder of laravel. The public folder is the entry point for the application.
3. Run 'composer install' using Composer
4. Create the database that will be used for the application.
5. Edit database.php in app/config/ and provide the database name and connection parameters.
6. Run the migrations and seeds provided in the project. See the database section for more info.
7. If all went well, you should be done.

By default the name of the database is:

wine

This can easily be changed if needed in the database.php file located under the app/config/ directory.

• There are many more tables here than what is needed for this demo. The plan was to create a much larger application to showcase laravel, but there was not time to do so.
• Most of these id fields are not an auto incrementing id. This is because the real project that this demo is based on did not have auto incrementing id's. The items used in the demo already had id's that the company was using, and so those had to be chosen over auto incrementing ones. It should also be noted that varchar had to be used instead of ints because thier existing id system included characters.

All of the table structure has been listed below for reference. Tables can be created and seeded using the artisan commands provided by Laravel. All of the migrations and seeds are already created, but the commands to run them needs to be issued. For instructions on how to do this, refer to the Laravel site.