0. AUTHOR AND HACK INFORMATION
0.1 AUTHOR
This hack is created by Joshua de Gier
It uses code from vBA CMPS 3.1.0 to run properly
http://www.vbadvanced.com
Tested on:
vBulletin 3.7.2 and vBA CMPS 3.1.0
Should work on:
vBA CMPS 3.0+
vBulletin 3.6.x / 3.7.x / 3.8.x
0.2 HACK INFORMATION
Version: 0.2b
Secured the script from SQL injections
Version: 0.1b
Info: this is the first beta version of this hack, no installer or whatsoever is added. I'm looking for co-authors who can help me getting used to the vB product system and auto-template changes and template installations
File edits: 0
File uploads: 6
Database changes: 0
New Database tables: 5
Template edits: 1
New Templates: 1
New vBA CMPS Pages: 4
New vBA CMPS Modules: 1
1. INSTALL INSTRUCTIONS
1.1 SQL IMPORT
Included in the ZIP-file there is a .sql file. Open your PHPMyAdmin and import this file into your database this file creates the tables for the webshop.
1.2 FILE UPLOADS
Upload all files from the upload folder in the zip to your forum root in the matching folders
1.3 TEMPLATE EDITS
-> Open template 'adv_portal' and find this code:
HTML Code:
$home[leftblocks]
-> Above this add:
HTML Code:
<if condition="$show['shopping_cart']">$home[shop]</if>
-> Save template
1.4 NEW TEMPLATES
-> Create a new template called 'adv_portal_shoppingcart' and add this inside the field:
-> Save template
1.5 NEW vBA CMPS PAGES
You have to add 4 new pages to your vBA CMPS system, in your admincp go to 'vBa CMPS -> Add Page':
1.5.1 CART
-> Page Title: Cart
-> Page Identifier: cart
-> Order/Keywords/Desc: free to choose yourself
-> Parent page: none
-> Custom style: free to choose yourself
-> Page active: yes
-> Path to file: modules/shop/cart.php
-> Clean File Output: no
-> Use Wrapper Temp: no
1.5.2 CHECKOUT
-> Page Title: Checkout
-> Page Identifier: checkout
-> Order/Keywords/Desc: free to choose yourself
-> Parent page: none
-> Custom style: free to choose yourself
-> Page active: yes
-> Path to file: modules/shop/checkout.php
-> Clean File Output: no
-> Use Wrapper Temp: no
1.5.3 SHOP
-> Page Title: Shop
-> Page Identifier: webshop
-> Order/Keywords/Desc: free to choose yourself
-> Parent page: none
-> Custom style: free to choose yourself
-> Page active: yes
-> Path to file: modules/shop/shop.php
-> Clean File Output: no
-> Use Wrapper Temp: no
1.5.3 SHOP ADMIN
-> Page Title: Shop Admin
-> Page Identifier: shop_admin
-> Order/Keywords/Desc: free to choose yourself
-> Parent page: none
-> Custom style: free to choose yourself
-> Page active: yes
-> Path to file: modules/shop/shop_admin.php
-> Clean File Output: no
-> Use Wrapper Temp: no
1.6 NEW vBA CMPS MODULES
You have to add 1 new module to your vBA CMPS system, in your admincp go to 'vBa CMPS -> Add Module':
1.6.1 SHOPPING CART
-> Module Title: Shopping Cart
-> Active: yes
-> Module Parent: none
-> Templates used: adv_portal_shoppingcart
-> Page active: yes
-> Clean File output: yes
1.7 INSTALLATION FINISHED
You have now finished the installation!
2. CONFIGURATION AND LINKS
You now have to perform some change to your navbar/quick links, where you want to add them is completely up to you. The links you can use depend on how your vBa CMPS file is called. Let's say it's still the default filename:
cmps_index.php. In that case you can use the links:
Webshop
HTML Code:
cmps_index.php?pageid=webshop
Shop Admin
HTML Code:
cmps_index.php?pageid=shop_admin
Go to your Shop Admin page and click 'Settings' from the leftside menu. Now configure your settings (also change the vBA CMPS page if it differs from the default cmps_index.php file!).
3. VERSIONS & FEATURES
VERSION:- version 0.1b
This is the first version of the vBA CMPS Webshop script. It's very basic right now and open for beta testing and feature requests. However, it could take a while for requests to be added as I do not have much spare time left. Therefor I'm looking for a Co-Author who is willing to help me with this modification (perhaps also with making a product for template changes, etc.)
FEATURE LIST:- Shop home: category overview + 5 latest products
- Shop category: product overview
- Shop Products: view products
- Shopping Cart: add products to cart
- Shopping Cart: update/delete items in your cart
- Member Discount: you can add special discount for forum members! This is perhaps a good way to attract members to your forums.
- Unique user sessions: these are either based on user-id (if logged in) or ip-adres (if logged out). Shopping carts save infos as long as the order is not finished. If the order is finished, a new shopping-session will be created as soon as a product is added to the shopping cart
- Unique owner per shop: you have the ability to add a specific user as a shop owner, this user can add/edit/delete products in this category and will receive an e-mail as soon as a product is ordered from his/her category
- Order proces: orders are processed via mail! There are no online payment methods so far!
- As each category has it's own owner, the proces will create a mail going out to each of them ONLY CONTAINING the products ordered from their category. If they manage multiple categories, it still will be one email
- The user who ordered also receives an e-mail containing the complete order
4. UPCOMING FEATURES
There are a couple of features i'd like to add, as I haven't added them so far:
- Image uploader (+ auto thumbnail)
- Online Payment Processing via PayPal
- Add/Edit/Delete buttons in frontpage if a users is an admin or the category owner
- Show all orders in admin area (closed sessions)
- Shop open session (sorted by start date) and have an option to delete sessions older than x days (to clean up database)
- View orders: this page shows all of your orders in the past like the shopping basket
5. SCREENSHOTS
5.1: Homepage of the webshop, displaying the categories and random products
5.2: Categorie page: product listing
5.3: Shopping cart
5.4: Shopping cart updated (multiple products)
5.5: Submit order form (user details)
5.6: Order succesfull notice (if a field was left empty, the form will be reloaded and displays an error message)
5.7: Admin: Edit category (add category uses the same form)
5.8: Admin: Edit product (add product uses the same form)
5.9: Settings which can be editted
5.10: Admin: view categories
5.11: Admin: view products in category
5.12: Order e-mail received by both the website owner and the user who has order the product
That's it so far! Hopefully you'll enjoy this as much as I will