Skip to content

Commit df4bf23

Browse files
authored
Merge pull request #87 from techlab/sw-2020
jQuery SmartWizard v5.0.0
2 parents b4d58a6 + 673d5b7 commit df4bf23

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

56 files changed

+6425
-3463
lines changed

.gitignore

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,4 @@
1-
/mpp-sw.txt
2-
/examples/smartwizard-bs.html
3-
/examples/Wizard Button.html
1+
/ref.txt
42
/node_modules/
53
/bower_components/
64
/vendor/

.npmignore

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -58,9 +58,7 @@ Thumbs.db
5858
.Spotlight-V100
5959
.Trashes
6060

61-
/mpp-sw.txt
62-
/examples/smartwizard-bs.html
63-
/examples/Wizard Button.html
61+
/ref.txt
6462
/node_modules/
6563
/bower_components/
6664
/vendor/

CONTRIBUTING.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Contributing
22

33
## How can I contribute?
4-
- Fix a bug you found or already reported on the [GitHub Issues Tracker](https://github.com/techlab/SmartWizard/issues/).
4+
- Fix a bug you found or already reported on the [GitHub Issues Tracker](https://github.com/techlab/jquery-smartwizard/issues/).
55
- Add new features to the project.
66
- Create new themes
77
- Add new test cases.
@@ -12,7 +12,7 @@
1212
## How to contribute code?
1313
Here are the basic steps to get started contributing code:
1414

15-
1. Fork the [repo](https://github.com/techlab/SmartWizard/) and get development running on your computer.
15+
1. Fork the [repo](https://github.com/techlab/jquery-smartwizard/) and get development running on your computer.
1616
2. Install gulp and karma `npm install gulp-cli karma-cli -g`
1717
3. Install the npm development dependencies by the command `npm install` on the project folder (Should have NodeJS installed).
1818
4. Replicate the issue you're trying to fix or spec out the feature you're trying to add.
@@ -22,7 +22,7 @@ Here are the basic steps to get started contributing code:
2222
8. Run the test cases by running `npm test` or `gulp test`, you can also add more test cases based on your new change.
2323
9. Verify that your fix or feature works.
2424
10. Commit your changes with an informative description.
25-
11. Open a pull request to the [dev](https://github.com/techlab/SmartWizard/tree/dev) branch of the [repo](https://github.com/techlab/SmartWizard/) with your new commit and a descriptive message about what the PR does.
25+
11. Open a pull request to the [dev](https://github.com/techlab/jquery-smartwizard/tree/dev) branch of the [repo](https://github.com/techlab/jquery-smartwizard/) with your new commit and a descriptive message about what the PR does.
2626

2727
Thank you for your contribution!
2828

@@ -39,8 +39,8 @@ Before reporting the bug, please make sure that the bug is in the project and no
3939
#### Try the latest version
4040
Bugs in the older versions of the project may have already been fixed.
4141
In order to avoid reporting known issues, make sure you are always testing against the latest release.
42-
Also make sure the problem hasn't already been reported on the [GitHub Issues Tracker](https://github.com/techlab/SmartWizard/issues/).
42+
Also make sure the problem hasn't already been reported on the [GitHub Issues Tracker](https://github.com/techlab/jquery-smartwizard/issues/).
4343
If not, create a new issue there and include your test case.
4444

4545
## Contributors
46-
Million thanks to all our [Code Contributors](https://github.com/techlab/SmartWizard/graphs/contributors) and Supporters.
46+
Million thanks to all our [Code Contributors](https://github.com/techlab/jquery-smartwizard/graphs/contributors) and Supporters.

README.md

Lines changed: 137 additions & 74 deletions
Original file line numberDiff line numberDiff line change
@@ -1,39 +1,44 @@
1-
# jQuery Smart Wizard 4
2-
#### The awesome jQuery step wizard plugin with Bootstrap support.
1+
# jQuery Smart Wizard v5
2+
#### The awesome jQuery step wizard plugin.
33

44
[![Build Status](https://travis-ci.org/techlab/jquery-smartwizard.svg?branch=master)](https://travis-ci.org/techlab/jquery-smartwizard)
55
[![npm version](https://badge.fury.io/js/smartwizard.svg)](https://badge.fury.io/js/smartwizard)
66
[![Latest Stable Version](https://poser.pugx.org/techlab/smartwizard/v/stable)](https://packagist.org/packages/techlab/smartwizard)
7-
[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/techlab/SmartWizard/master/LICENSE)
7+
[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/techlab/jquery-smartwizard/master/LICENSE)
88
[![Donate on Paypal](https://img.shields.io/badge/PayPal-dipuraj-blue.svg)](https://www.paypal.me/dipuraj)
99

10-
Smart Wizard is a flexible and heavily customizable **jQuery step wizard plugin** with **Bootstrap** support. It is easy to implement and gives a neat and stylish interface for your forms, checkout screen, registration steps etc. Based on the feedback from our users over the past years we have come up with the **best ever built jQuery wizard plugin of all time**, all new Smart Wizard 4. The plugin is been completely rewritten from scratch, made it more powerful, robust, scalable and customizable. We have added a lot of features not limited to Bootstrap 4 support, themes, customizable toolbars, customizable options, public methods, event support and a lot more.
1110

12-
+ [Homepage](http://techlaboratory.net/smartwizard)
13-
+ [Documentation](http://techlaboratory.net/smartwizard#documentation)
14-
+ [Demos](http://techlaboratory.net/smartwizard#demo)
11+
**jQuery Smart Wizard** is a step wizard plugin for jQuery.
12+
Provides a neat and stylish interface for your forms, checkout screen, registration steps, etc.
13+
Easy implementation, Bootstrap compatiblity, customizable toolbars, themes, events and Ajax support are few of the features.
14+
15+
16+
+ [Homepage](http://techlaboratory.net/jquery-smartwizard)
17+
+ [Documentation](http://techlaboratory.net/jquery-smartwizard#documentation)
18+
+ [Demos](http://techlaboratory.net/jquery-smartwizard#demo)
1519
+ [StackOverflow Q&A](http://stackoverflow.com/questions/tagged/smart-wizard)
16-
+ [GitHub Issues](https://github.com/techlab/SmartWizard/issues)
20+
+ [GitHub Issues](https://github.com/techlab/jquery-smartwizard/issues)
21+
22+
Demos
23+
-----
24+
+ [Basic Example](http://techlaboratory.net/projects/demo/jquery-smart-wizard/v5)
25+
+ [Ajax Example](http://techlaboratory.net/projects/demo/jquery-smart-wizard/v5/ajax)
26+
+ [Multiple Wizard Example](http://techlaboratory.net/projects/demo/jquery-smart-wizard/v5/multiple)
1727

1828
Screenshots
1929
-----
20-
![Smart Wizard Screenshot1](http://techlaboratory.net/assets/media/products/SmartWizard43_1.png?v1)
30+
![Smart Wizard Default](http://techlaboratory.net/assets/media/jquery-smart-wizard/jquery-smartwizard-v5-default.png)
2131

22-
![Smart Wizard Screenshot2](http://techlaboratory.net/assets/media/products/SmartWizard43_2.png?v1)
32+
![Smart Wizard Arrows](http://techlaboratory.net/assets/media/jquery-smart-wizard/jquery-smartwizard-v5-arrows.png)
2333

24-
![Smart Wizard Screenshot3](http://techlaboratory.net/assets/media/products/SmartWizard43_3.png?v1)
34+
![Smart Wizard Black](http://techlaboratory.net/assets/media/jquery-smart-wizard/jquery-smartwizard-v5-dark.png)
35+
36+
![Smart Wizard Dots](http://techlaboratory.net/assets/media/jquery-smart-wizard/jquery-smartwizard-v5-dots.png)
2537

26-
Demos
27-
-----
28-
+ [Basic Example](http://techlaboratory.net/projects/demo/jquery-smart-wizard/v4/basic)
29-
+ [Input Validation](http://techlaboratory.net/projects/demo/jquery-smart-wizard/v4/validation)
30-
+ [Events](http://techlaboratory.net/projects/demo/jquery-smart-wizard/v4/events)
31-
+ [With Modal Dialog](http://techlaboratory.net/projects/demo/jquery-smart-wizard/v4/modal)
3238

3339
Requirements
3440
-----
35-
+ [Bootstrap 4.0.0](http://getbootstrap.com/getting-started/#download)
36-
+ [jQuery](http://jquery.com/) (supports jQuery 1.9+, jQuery 2+ and jQuery 3+)
41+
+ [jQuery](http://jquery.com/) (supports from jQuery-1.11.1+ to the latest jQuery-3.5)
3742

3843
Installation
3944
-----
@@ -51,93 +56,151 @@ Installation
5156
composer require techlab/smartwizard
5257

5358
### Download
54-
#### [Download from GitHub](https://github.com/techlab/jquery-smartwizard/archive/master.zip)
59+
#### [Download from GitHub](https://github.com/techlab/jquery-smartwizard/archive/master.zip)
60+
61+
Features
62+
-----
63+
64+
- Standalone CSS
65+
- Bootstrap compatible
66+
- Various themes included
67+
- Customizable CSS
68+
- URL navigation and selection
69+
- Event support
70+
- Ajax content loading support
71+
- Keyboard navigation
72+
- Auto content height adjustment
73+
- Cool transition animations (fade/slide-horizontal/slide-vertical/slide-swing)
74+
- External anchor support
75+
- Easy to implement and minimal HTML required
76+
- Customizable toolbar, option to add extra buttons
77+
- Compatible with all jQuery versions (jQuery 1.11.1+, jQuery 2+, jQuery 3.5+)
78+
- Supports all modern browsers
79+
- Responsive design
80+
- In-built reset method
81+
- Easy navigation with step anchors and navigation buttons
5582

5683
Usage
5784
-----
5885

59-
Include Bootstrap CSS (*ignore this if you have already included on the page*).
60-
```html
61-
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0/css/bootstrap.min.css" >
62-
```
6386
Include SmartWizard CSS
6487
```html
65-
<link href="../dist/css/smart_wizard.css" rel="stylesheet" type="text/css" />
88+
<link href="../dist/css/smart_wizard_all.min.css" rel="stylesheet" type="text/css" />
6689
```
67-
Optionally, if you want to use the theme include the corresponding theme css
68-
```html
69-
<link href="../dist/css/smart_wizard_theme_arrows.css" rel="stylesheet" type="text/css" />
70-
```
71-
Include HTML (*This is the basic HTML markup for the Smart Wizard. You can customize it by adding your on steps contents*).
90+
91+
Include HTML (*This is the basic HTML markup for the Smart Wizard. You can customize it by adding your on steps content*).
7292
```html
7393
<div id="smartwizard">
74-
<ul>
75-
<li><a href="#step-1">Step Title<br /><small>Step description</small></a></li>
76-
<li><a href="#step-2">Step Title<br /><small>Step description</small></a></li>
77-
<li><a href="#step-3">Step Title<br /><small>Step description</small></a></li>
78-
<li><a href="#step-4">Step Title<br /><small>Step description</small></a></li>
94+
95+
<ul class="nav">
96+
<li class="nav-item">
97+
<a class="nav-link" href="#step-1">
98+
Step 1
99+
</a>
100+
</li>
101+
<li class="nav-item">
102+
<a class="nav-link" href="#step-2">
103+
Step 2
104+
</a>
105+
</li>
106+
<li class="nav-item">
107+
<a class="nav-link" href="#step-3">
108+
Step 3
109+
</a>
110+
</li>
111+
<li class="nav-item">
112+
<a class="nav-link" href="#step-4">
113+
Step 4
114+
</a>
115+
</li>
79116
</ul>
80117

81-
<div>
82-
<div id="step-1" class="">
83-
Step Content
118+
<div class="tab-content">
119+
<div id="step-1" class="tab-pane" role="tabpanel" aria-labelledby="step-1">
120+
Step 1 Content
84121
</div>
85-
<div id="step-2" class="">
86-
Step Content
122+
<div id="step-2" class="tab-pane" role="tabpanel" aria-labelledby="step-2">
123+
Step 2 Content
87124
</div>
88-
<div id="step-3" class="">
89-
Step Content
125+
<div id="step-3" class="tab-pane" role="tabpanel" aria-labelledby="step-3">
126+
Step 3 Content
90127
</div>
91-
<div id="step-4" class="">
92-
Step Content
128+
<div id="step-4" class="tab-pane" role="tabpanel" aria-labelledby="step-4">
129+
Step 4 Content
93130
</div>
94131
</div>
95132
</div>
96133
```
97-
Include jQuery (*ignore this if you have already included on the page*).
134+
135+
Include jQuery (*ignore this if you have already included on the page*).
98136
```html
99137
<script src="https://code.jquery.com/jquery-3.3.1.min.js"></script>
100138
```
139+
101140
Include SmartWizard plugin
102141
```html
103-
<script type="text/javascript" src="../dist/js/jquery.smartWizard.min.js"></script>
142+
<script src="../dist/js/jquery.smartWizard.min.js" type="text/javascript"></script>
104143
```
105144
Initialize the SmartWizard
106-
```javascript
145+
```html
107146
<script type="text/javascript">
108-
$(document).ready(function(){
147+
$(document).ready(function() {
109148
110149
$('#smartwizard').smartWizard();
111150
112151
});
113152
</script>
114153
```
115-
That's it! Now you see the wizard on the page.
116-
Please see the [documentation](http://techlaboratory.net/smartwizard#documentation) for more details on implementation and usage.
117-
118-
Features
119-
-----
120-
+ Bootstrap 3 & 4 support
121-
+ Responsive themes
122-
+ Heavily customizable toolbar, option to add extra buttons
123-
+ Theme support with various themes included
124-
+ Customizable css styles
125-
+ Url navigation and step selection
126-
+ Public methods for external function call
127-
+ Enhanced event support
128-
+ In-built wizard reset method
129-
+ Ajax content loading with option to specify individual url for steps
130-
+ Keyboard navigation
131-
+ Easy navigation with step anchors and navigation buttons
132-
+ Multiple wizard instance on same page
133-
+ Integratable to model window
134-
+ Dynamically hide or disable steps
135-
+ Auto content height adjustment
136-
+ Compatible with latest jQuery versions (jQuery 1.9+, jQuery 2+, jQuery 3+)
137-
+ Easy to implement, Minimal HTML required
138-
+ and a lot more...
139-
140-
> Please use jQuery full version (`jquery-3.3.x.min.js`) as the jQuery slim version (`jquery-3.3.x.slim.min.js`) is not yet supported.
154+
That's it!
155+
156+
Please see the [documentation](http://techlaboratory.net/jquery-smartwizard#documentation) for more details on implementation and usage.
157+
158+
##### All options
159+
160+
```JavaScript
161+
$('#smartwizard').smartWizard({
162+
selected: 0, // Initial selected step, 0 = first step
163+
theme: 'default', // theme for the wizard, related css need to include for other than default theme
164+
justified: true, // Nav menu justification. true/false
165+
autoAdjustHeight: true, // Automatically adjust content height
166+
cycleSteps: false, // Allows to cycle the navigation of steps
167+
backButtonSupport: true, // Enable the back button support
168+
enableURLhash: true, // Enable selection of the step based on url hash
169+
transition: {
170+
animation: 'none', // Effect on navigation, none/fade/slide-horizontal/slide-vertical/slide-swing
171+
speed: '400', // Transion animation speed
172+
easing:'' // Transition animation easing. Not supported without a jQuery easing plugin
173+
},
174+
toolbarSettings: {
175+
toolbarPosition: 'bottom', // none, top, bottom, both
176+
toolbarButtonPosition: 'right', // left, right, center
177+
showNextButton: true, // show/hide a Next button
178+
showPreviousButton: true, // show/hide a Previous button
179+
toolbarExtraButtons: [] // Extra buttons to show on toolbar, array of jQuery input/buttons elements
180+
},
181+
anchorSettings: {
182+
anchorClickable: true, // Enable/Disable anchor navigation
183+
enableAllAnchors: false, // Activates all anchors clickable all times
184+
markDoneStep: true, // Add done state on navigation
185+
markAllPreviousStepsAsDone: true, // When a step selected by url hash, all previous steps are marked done
186+
removeDoneStepOnNavigateBack: false, // While navigate back done step after active step will be cleared
187+
enableAnchorOnDoneStep: true // Enable/Disable the done steps navigation
188+
},
189+
keyboardSettings: {
190+
keyNavigation: true, // Enable/Disable keyboard navigation(left and right keys are used if enabled)
191+
keyLeft: [37], // Left key code
192+
keyRight: [39] // Right key code
193+
},
194+
lang: { // Language variables for button
195+
next: 'Next',
196+
previous: 'Previous'
197+
},
198+
disabledSteps: [], // Array Steps disabled
199+
errorSteps: [], // Highlight step with errors
200+
hiddenSteps: [] // Hidden steps
201+
});
202+
</script>
203+
```
141204

142205
License
143206
----

bower.json

Lines changed: 0 additions & 39 deletions
This file was deleted.

composer.json

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
{
22
"name": "techlab/smartwizard",
3-
"description": "The awesome jQuery step wizard plugin with Bootstrap support",
4-
"homepage": "http://techlaboratory.net/smartwizard",
3+
"description": "The awesome jQuery step wizard plugin",
4+
"homepage": "http://techlaboratory.net/jquery-smartwizard",
55
"license": "MIT",
66
"support": {
7-
"source": "https://github.com/techlab/SmartWizard",
8-
"issues": "https://github.com/techlab/SmartWizard/issues",
9-
"docs": "http://techlaboratory.net/smartwizard/documentation"
7+
"source": "https://github.com/techlab/jquery-smartwizard",
8+
"issues": "https://github.com/techlab/jquery-smartwizard/issues",
9+
"docs": "http://techlaboratory.net/jquery-smartwizard#documentation"
1010
},
1111
"keywords": [
1212
"bootstrap",
@@ -20,8 +20,8 @@
2020
"authors": [
2121
{
2222
"name": "Dipu Raj",
23-
"email": "hello@techlaboratory.net",
24-
"homepage": "http://dipuraj.me"
23+
"email": "hello[email protected]",
24+
"homepage": "http://dipu.me"
2525
}
2626
],
2727
"require": {

0 commit comments

Comments
 (0)