Documentation
This page includes all designed elements which you may use while creating sites based on this template.
Start Exploring Go to chooserGetting Started
Soup is a HTML/CSS template based on Bootstrap 4framework. It allows to built modern, fast and mobile friendly websites for restaurants. What's more it includes componentes for online ordering system.
HTML Structure
This is the base of each HTML file:
<!-- Header --><header id="header"> ...</header><!-- Header / End --><!-- Content --><div id="content"> <!-- Section --> <section> ... </section> <!-- Footer --> <footer> ... </footer></div><!-- Content / End -->
Grid System
Soup Template supporst all features of BootstrapGrid System - go to Bootrstrap's pageand check how does it work.
Content
It will be pleasure to build content with this stuff!. More at Bootstrap's 4 page.
Typography
Useful elements to create nice texts.
Headings
h1. Bootstrap heading
h2. Bootstrap heading
h3. Bootstrap heading
h4. Bootstrap heading
h5. Bootstrap heading
h6. Bootstrap heading
<h1>h1. Bootstrap heading</h1><h2>h2. Bootstrap heading</h2><h3>h3. Bootstrap heading</h3><h4>h4. Bootstrap heading</h4><h5>h5. Bootstrap heading</h5><h6>h6. Bootstrap heading</h6>
Paragraph
Maecenas a risus quis ipsum convallis fringilla in ut magna. Phasellus et sagittis odio. Sed in enim condimentum, lacinia metus id, sollicitudin libero. In ac ultricies justo.
Curabitur sit amet turpis eu diam luctus viverra. Sed viverra ornare ex, quis lobortis diam vehicula a. In imperdiet est tristique, malesuada odio quis, volutpat ante. Nulla ullamcorper, nisl sed faucibus posuere, dui turpis mattis turpis, in porttitor massa odio nec sapien.
<p class="lead">...</p><p>...</p>
Blockquote
Blocquote with alternative .light
version.
Great food and great atmosphere!
<!-- Blockquote --><blockquote class="blockquote"> <div class="blockquote-content dark"> <div class="rate rate-sm mb-3"><i class="fa fa-star active"></i><i class="fa fa-star active"></i><i class="fa fa-star active"></i><i class="fa fa-star active"></i><i class="fa fa-star"></i></div> <p>Great food and great atmosphere!</p> </div> <footer> <img src="assets/img/avatars/avatar01.jpg" alt=""> <span class="name">Kate Hudson<span class="text-muted">, LinkedIn</span></span> </footer></blockquote>
Code
Easy & effectife way to resent code. More at Bootstrap's 4 page.
Inline code
<section>
should be wrapped as inline.
For example, <code><section></code> should be wrapped as inline.
Code block
<p>Sample text here...</p><p>And another line of sample text here...</p>
<pre><code><p>Sample text here...</p><p>And another line of sample text here...</p></code></pre>
Images
<img src="..." alt="..." class="rounded"><img src="..." alt="..." class="img-thumbnail">
Icons
Soup template includes two fantastic sets of icons - Themify Iconsand Line Icons
Basic Icons
Circle Icons
Colors
Each icon may be used in any color from Available Colorssection. Please use .icon-[color-name]
- for example:
Social Icons
This product supports lots of social icon types.
Components
Thanks to the prepared components you will be able to create really cool and effective, easy to use websites. Let's start exploring them!
Alerts
<div class="alert alert-success" role="alert"> ...</div><div class="alert alert-info" role="alert"> ...</div><div class="alert alert-warning" role="alert"> ...</div><div class="alert alert-danger" role="alert"> ...</div>
Forms
To validate the form please add data-validate
attribute and required
atribute to input
/ textarea.
<form action="#" class="validate-form"> <div class="form-group"> <label>Your e-mail</label> <input name="email" type="email" class="form-control" required> </div> <div class="form-group"> <label>Your message</label> <textarea name="message" id="message" cols="30" rows="5" class="form-control" required></textarea> </div> <div class="form-group form-submit"> <button type="submit" class="btn btn-primary btn-block"><span>Send message!</span></button> </div></form>
Pagination
<ul class="pagination"> <li class="page-item"> <a class="page-link" href="#" aria-label="Previous"> <i class="ti-angle-left"></i> <span class="sr-only">Previous</span> </a> </li> <li class="page-item"><a class="page-link" href="#">1</a></li> <li class="page-item active"><a class="page-link" href="#">2</a></li> <li class="page-item"><a class="page-link" href="#">3</a></li> <li class="page-item"><a class="page-link" href="#">4</a></li> <li class="page-item"><a class="page-link" href="#">5</a></li> <li class="page-item"> <a class="page-link" href="#" aria-label="Next"> <i class="ti-angle-right"></i> <span class="sr-only">Next</span> </a> </li></ul>
Tabs
Feel free to use the tabs for dynamic content.
<!-- Nav Pills --><ul class="nav nav-pills nav-fill mb-3" role="tablist"> <li class="nav-item"><a class="nav-link active" href="#home" aria-controls="home" role="tab" data-toggle="tab">Home</a></li> <li class="nav-item"><a class="nav-link" href="#profile" aria-controls="profile" role="tab" data-toggle="tab">Profile</a></li> <li class="nav-item"><a class="nav-link" href="#messages" aria-controls="messages" role="tab" data-toggle="tab">Messages</a></li></ul><!-- Tab Panes --><div class="tab-content"> <div role="tabpanel" class="tab-pane fade in active" id="home">...</div> <div role="tabpanel" class="tab-pane fade" id="profile">...</div> <div role="tabpanel" class="tab-pane fade" id="messages">...</div></div>
Modal
Modal window is perfect place for any kind of content.
<!-- Button trigger modal --><button type="button" class="btn btn-blue btn-lg" data-toggle="modal" data-target="#demoModal"><span>Launch demo modal</span></button><!-- Modal / Demo --><div class="modal fade" id="demoModal" role="dialog"> <div class="modal-dialog" role="document"> <div class="modal-content"> <div class="modal-header"> <h4 class="modal-title" id="myModalLabel">Modal title</h4> <button type="button" class="close" data-dismiss="modal" aria-label="Close"><i class="ti-close"></i></button> </div> <div class="modal-body"> ... </div> <div class="modal-footer"> <button type="button" class="btn btn-dark" data-dismiss="modal">Close</button> <button type="button" class="btn btn-primary">Save changes</button> </div> </div> </div></div>
Sizes
Modals have three optional sizes .modal-sm
, .modal-lg
available via modifier classes to be placed on a .modal-dialog.
Video Modal
Video Modal was created to place video in popup window. Use data-video
attribute to place url to your video.
<!-- Button trigger modal --><a href="#" class="btn-play-2" data-toggle="video-modal" data-target="#modalVideo" data-video="https://www.youtube.com/embed/uVju5--RqtY"><span></span>Check it now!</a><!-- Video Modal / Demo --><div class="modal modal-video fade" id="modalVideo" role="dialog"> <button class="close" data-dismiss="modal"><i class="ti-close"></i></button> <div class="modal-dialog modal-lg" role="document"> <div class="modal-content"> <iframe height="500"></iframe> </div> </div></div>
Carousel
Carousel is a component perfect to preset any kind of content like photos, icons, texts, etc. Go to the Slick's pageto see full documentation of this components.
<!-- Carousel --><div class="carousel carousel-items" data-slick='{ "slidesToShow": 3, "slidesToScroll": 1, "dots": true, "arrows": false, "responsive": [ { "breakpoint": 991, "settings": { "slidesToShow": 2 } }, { "breakpoint": 575, "settings": { "slidesToShow": 1 } } ] }'> <div class="carousel-item"> ... </div> <div class="carousel-item"> ... </div> <div class="carousel-item"> ... </div> <div class="carousel-item"> ... </div> <div class="carousel-item"> ... </div></div>
Badges
DefaultPrimarySuccessInfoWarningDanger
Tooltips
Hover the buttons to see the tooltips.
Utilities
Below are listed important configuration options for whole template.
Available Colors
Colour scheme:
primary
secondary
Other:
info
success
warning
danger
light
white
dark
black
Helper Classes
Text Colors
It is possible to add any color form Available Colorssection by .text-[color-name]
class
Fusce dapibus, tellus ac cursus commodo, tortor mauris nibh.
Backgrounds
Similar to text colors it is possible to add backgorund color from Available Colorssection by .bg-[color-name]
class.
For dark background colors it is necessary to add dark
class to adjust font colors and other styles. Sometimes, if inside dark element is placed element with light background you should add light
class to such element.
Fusce dapibus, tellus ac cursus commodo, tortor mauris nibh.
<p class="bg-success dark p-2">Fusce dapibus, tellus ac cursus commodo, tortor mauris nibh.</p>
Border
It is possible to add border to any of html elements by adding proper class:
-
.border
- adds border to element -
.border-top
- adds top border to element -
.border-bottom
- adds bottom border to element
<div class="pb-10 border-bottom">Element with border-bottom.</div>
Heights & vertical center position
The template allows to set minimial height of block html element. It is possible by using .h-[value]
class.
[value] is a number from 100 to 900 with 100 gap or sm (40% of viewport), md (60% of viewport) and lg (80% of viewport).
By .fullheight
class you set elements height equal to the browser viewport height.
Using .v-center
class makes element positioned vertically center in relation to the parent.
H2 inside 200px container.
<div class="bg-light h-200"> <h2 class="text-center mb-0 v-center">H2 inside 200px container.</h2></div>
More useful helper classes are listed on Bootstrap's 4 website!
Configuration
The template includes some configurable elements - here you will find informations how to use them!
Google Map
To configure Google Map it is necessary to set latitude and longitude parameters by data-latitude
and data-longitude
attributes of #google-map
element. To get it please visit site like this.
<div id="google-map" class="h-400" data-latitude="40.758895" data-longitude="-73.985131" data-style="dream"></div>
Map supports few color themes - to set it please use data-style
attribute.
Available Themes
- wy
- apple
- dark
Booking Form
To configure booing form please open booking-form.phpfile from /assets/phpdirectory and go the line with an e-mail address to change it to your own - like this.
$emailTo = 'your@email.com';
After that you will recieve the messages from your websites to this e-mail address.
SignUp Form
SignUp form is made with MailchimpAPI.
How to create the form?
- Log into the Mailchimpsite.
- Create subscribers list.
- Get into the list and go to "Signup forms" tab.
- Pick "Embedded forms".
- Pick "Classic version" and copy / paste somewhere generated code (don't change anything).
- Find
form
selector and copyaction
atribute valuse into your form. Remember to addmethod="POST"
attribute. - Modify action URI by changing
.../post?...
to.../post-json?...
. It should look like thisaction="//suelo.us12.list-manage.com/subscribe/post-json?u=ed47dbfe167d906f2bc46a01b&id=24ac8a22ad"
- Find email input and copy
type
,name
andid
to your input - it should look like this:<input type="email" value="" name="EMAIL" class="form-control input-lg" id="mce-EMAIL">
- Find input which prevents bot signups and paste it somewhere in the form - it should be hidden!
- Add submit button and enjoy your working Sign Up form!
Local Scroll
If you want to use local scroll somewhere in the content please add data-local-scroll
attribute in the parent selector of a link to local selector.
Aniamtions
The template allows to add really cool animations for each of html elements. Let's check how to use it!
Entrance animation
This animation fires when element appears in the browser viewport. To add such animation you need to place .animated
class in the animted element and preciese which animation do you want to use by data-animation
attribute. It is also possible to add some delay to the animation (in ms) by data-animation-delay
attribute.
Developer Tools
The template was made with NPMpackage manager and Grunt.jstask manager.
NPM
The template includes two package.json
files:
package.json
This file includes necessary grunt tasks to make developemnt process nice and easy. Run npm install
task to install them.
assets/plusings/package.json
This file includes all plugins used in this theme. To install those plugins you need to run npm install
as previously but after that you have to run grunt copy
and grunt remove
tasks to move them into right directory
Grunt.js
The package includes some grunt tasks to make development process easier:
-
grunt
- runsgrunt sass
tasks after each .scss file change -
grunt sass
- compiles all .scss files -
grunt validation
- makes HTML5 validation of each .html file
Files & Credits
CSS Files
The template uses couple of CSS files:
<!-- CSS Plugins --><link rel="stylesheet" href="assets/plugins/bootstrap/dist/css/bootstrap.min.css" /><link rel="stylesheet" href="assets/plugins/slick-carousel/slick/slick.css" /><link rel="stylesheet" href="assets/plugins/animate.css/animate.min.css" /><link rel="stylesheet" href="assets/plugins/animsition/dist/css/animsition.min.css" /><!-- CSS Icons --><link rel="stylesheet" href="assets/css/themify-icons.css" /><link rel="stylesheet" href="assets/plugins/font-awesome/css/font-awesome.min.css" /><!-- CSS Theme --><link id="theme" rel="stylesheet" href="assets/css/themes/theme-[color].min.css" />
CSS Theme has - was divided into some important sections:
1. Setup2. Basic3. Header -- 4.1 Header Mobile-- 4.2 Navigation Desktop4. Content -- 4.1 Blog-- 4.2 Features-- 4.3 Menu-- 4.4 Other-- 4.5 Page Title-- 4.6 Sections5. Footer6. Elements -- 6.1 Alerts-- 6.2 Backgrounds-- 6.3 Badges-- 6.4 Buttons-- 6.5 Carousel-- 6.6 Forms -- 6.7 Icons-- 6.8 Loader-- 6.9 Modals-- 6.10 Navigations-- 6.11 Notification Bar-- 6.12 Other-- 6.13 Pagination-- 6.14 Testimonials-- 6.15 Typography7. Widgets 8. Animations
CSS Theme is also available in couple of diffrent color versions:
theme-beige.csstheme-blue.csstheme-green.csstheme-mint.csstheme-orange.csstheme-red.csstheme-teal.css
Documentation uses one addiotional prettify.css
stylesheet for code highlighter.
SASS Files
CSS files are generated thanks to well organized SCSS files.
├── _animations.scss├── _base.scss├── _basics.scss├── _config.scss├── _content│ ├── _blog.scss│ ├── _features.scss│ ├── _menu.scss│ ├── _other.scss│ ├── _page-title.scss│ └── _sections.scss├── _content.scss├── _elements│ ├── _alerts.scss│ ├── _backgrounds.scss│ ├── _badges.scss│ ├── _buttons.scss│ ├── _carousel.scss│ ├── _forms.scss│ ├── _icons.scss│ ├── _loader.scss│ ├── _modals.scss│ ├── _navs.scss│ ├── _notification-bar.scss│ ├── _other.scss│ ├── _pagination.scss│ ├── _panel-cart.scss│ └── _typography.scss├── _elements.scss├── _footer.scss├── _header│ ├── _header-mobile.scss│ └── _navigation-desktop.scss├── _header.scss├── _setup.scss├── _widgets.scss├── package.json├── theme-beige.scss├── theme-blue.scss├── theme-green.scss├── theme-mint.scss├── theme-orange.scss├── theme-red.scss└── theme-teal.scss
-
theme-[color-scheme].scss
is a main SCSS file where main colors have been set. -
_base.css
file is a base for each theme which imports other partials. -
_config.css
file with SASS variables which configure colors, fonts and more.
JavaScript Files
On the end of the body of each html file there are placed 4 JavaScrpt files:
-
plugins-bundle.js
- compressed file with all necessary plugins sources (more at credicts) -
core.js
- main JavaScript file -
http://cdn.dedemao.com/maps/api/js
Google Map API
Instead of plugins-bundle.js
it is also possible to use full plugins list:
<script src="assets/plugins/jquery/dist/jquery.min.js"></script><script src="assets/plugins/tether/dist/js/tether.min.js"></script><script src="assets/plugins/bootstrap/dist/js/bootstrap.min.js"></script><script src="assets/plugins/slick-carousel/slick/slick.min.js"></script><script src="assets/plugins/jquery.appear/jquery.appear.js"></script><script src="assets/plugins/jquery.scrollto/jquery.scrollTo.min.js"></script><script src="assets/plugins/jquery.localscroll/jquery.localScroll.min.js"></script><script src="assets/plugins/jquery-validation/dist/jquery.validate.min.js"></script><script src="assets/plugins/jquery.mb.ytplayer/dist/jquery.mb.YTPlayer.min.js"></script><script src="assets/plugins/twitter-fetcher/js/twitterFetcher_min.js"></script><script src="assets/plugins/skrollr/dist/skrollr.min.js"></script><script src="assets/plugins/animsition/dist/js/animsition.min.js"></script>
Elements page uses one addiotional assets/js/prettify.js
plugin for code highlighter.
PHP Files
The template includes few PHP scripts:
-
/php/booking-form.php
- configuration file for contact form
Credits
Fonts:
Icons:
- Themify Icons- http://themify.me/themify-icons
- Font Awesome- fontawesome.io/
Libraries:
- jQuery- http://jquery.com/
- Bootstrap 4- http://v4-alpha.getbootstrap.com/
Plugins:
- Tether- http://tether.io/
- Moment- http://momentjs.com/
- Appear- http://morr.github.io/appear.html
- LocalScroll- http://flesler.blogspot.com/2007/10/jquerylocalscroll-10.html
- ScrollTo- https://github.com/flesler/jquery.scrollTo
- Validate- https://jqueryvalidation.org/
- Twitter Post Fetcher- https://github.com/jasonmayes/Twitter-Post-Fetcher
- Slick- http://kenwheeler.github.io/slick/
- jquery.mb.YTPlayer- http://pupunzi.open-lab.com/mb-jquery-components/jquery-mb-ytplayer/
- Prettify- https://github.com/google/code-prettify
- Skrollr- https://github.com/Prinzhorn/skrollr
- Animsition- http://git.blivesta.com/animsition/
npm install; grunt copy; grunt remove
tasks in /assets/plugins/
.
Images:
Some images used in the template was free and have been included in a package. Rest of them was blurred becouse of licensing reasons.
Included images:
- https://www.pexels.com/photo/sliced-oranges-kiwi-melon-blueberry-and-dragonfruit-on-white-ceramic-platter-218844/
- https://www.pexels.com/photo/white-ceramic-round-plate-on-round-brown-ornament-24859/
- https://www.pexels.com/photo/pasta-with-vegetable-on-white-ceramic-round-plate-169743/
- https://www.pexels.com/photo/table-in-vintage-restaurant-6267/
- https://www.pexels.com/photo/chocolate-and-cherry-top-cake-129893/
- https://www.pexels.com/photo/red-drink-on-clear-glass-with-lemon-on-top-160150/
- https://www.pexels.com/photo/top-view-of-silver-macbook-beside-pumpkin-and-brown-wooden-tray-204693/
- https://www.pexels.com/photo/food-pizza-slice-fast-food-7907/
- https://www.pexels.com/photo/chopsticks-food-meal-sushi-80841/
- https://www.pexels.com/photo/food-restaurant-meal-chicken-106343/
- https://www.pexels.com/photo/burger-in-white-textile-52570/
- https://www.pexels.com/photo/pasta-dish-on-white-plate-26646/
- https://www.pexels.com/photo/avocado-ceramic-plate-chopsticks-culture-343870/
- https://www.pexels.com/photo/person-holding-clear-shot-glass-in-front-of-black-wooden-table-63943/
- https://www.pexels.com/photo/wine-glass-on-restaurant-table-225228/
- https://www.pexels.com/photo/table-with-plates-and-flowers-filed-neatly-selective-focus-photography-169190/
- https://www.pexels.com/photo/bar-blur-candle-celebration-299550/
- https://www.pexels.com/photo/black-and-copper-pen-169657/
- https://www.pexels.com/photo/board-bread-breakfast-bunch-349610/
- https://www.pexels.com/photo/restaurant-people-alcohol-bar-2286/
- https://www.pexels.com/photo/restaurant-bottles-dinner-lunch-66640/
- https://www.pexels.com/photo/brown-city-bike-near-person-wearing-white-and-black-shirt-white-sitting-outside-store-126371/
- https://www.pexels.com/photo/city-restaurant-table-pavement-4309/
- https://www.pexels.com/photo/close-up-of-hand-holding-coffee-cup-302902/
Changelog
What has changed since first version?