Monetary Shop 0.5.7 [Updated: 25th Nov, 2015]

[Peter]

This plugin is no longer available from the library or supported.

You can still download and install this plugin from the GitHub page: Monetary Plugins

Test the Shop plugin here: monetary.proboards.com

Monetary Shop

Please take a moment to like this post and rate the plugin.


Contents

1. Introduction
2. Help / FAQ
3. Integrating Into Custom Profile & Mini Profile Templates
4. Plugin Install
   
5. Adding The "Shop" Link To The Navigation
6. Screen Shots
7. Plugin Source
8. Plugin Changes

---

 

Introduction

Monetary System - Shop

This plugin is an addon for the Monetary System. It allows your members to use the currency they have earned to buy items from the shop and show them on their profile.

Please be sure to read all parts of this post, as it contains important information regarding installing and customising the system.

If you do have any issues, questions, or suggestions, please post in this topic, don't contact me directly.

Note: The Monetary System Shop plugin will require 1 super user key

---

 

Help / FAQ

- Shop isn't working, what's wrong with it?
  Make sure you follow the instructions below for installing.  Also make sure you are using a version of the Monetary System that is compatible.

- How do I create a link to a gift code for an item?
  The URL for shop gift codes is (replace CODE with your code): yourforum.proboards.com/?monetaryshop&gift=CODE

- The items are not showing on the profile, why?
  The most likely reason for this, is because you have made changes to your template.  Please see the section below on how to integrate it into your profile.

- The items are not showing up in the mini profile, why?
  If you have made changes to your mini profile template, then this is most likely why.  The code looks for each mini profile by search for a class called "mini-profile".   If this is not found, then the code can not add the items to the mini profile.

- The items are showing in the mini profile, but not where I want there, how can I position them?
  You can modify the mini profile template and add a class called "monetary_shop_items" to the element where you want the items to appear.

- How do I remove an item from a member?
  If the option is enabled in the settings, then staff can go to a members profile, click on the item they wish to remove and then click on the "remove" button in the dialog.

- I have ran out of space for items.  How do I add more items now?
  There are plugins you can install to add more items to your shop:

  www.proboards.com/library/plugins/item/856
  www.proboards.com/library/plugins/item/912
  www.proboards.com/library/plugins/item/914

- How can I resize the images with CSS?
  You can target the mini profile, profile, and shop images without needing to use the image size settings with the following bits of CSS.  Just change the width and height to the max you want them to be.  This way, small images remain unchanged.

   Mini Profiles:
.mini-profile .monetary_shop_items .pd_shop_mini_item img {

max-height: 20px;
max-width: 20px;

}
   Profiles:
.show-user .shop_items_list > img {

max-height: 20px;
max-width: 20px;

}
   Shop:
.container_monetaryshop .shop_ribbon img {

max-height: 20px;
max-width: 20px;

}
- I don't understand how to add images to the shop.
  The shop doesn't come with any images for items you want to sell, they must be uploaded by you to your own hosting, or a image hosting service.  Below is a screen shot of how a typical forum will add images to their shop from the plugin settings.

  i.imgur.com/Xrsqu7x.png

  The first field called "Image Base" is the base folder where your images are stored.  Images can be in sub folders under that base, so if you look at the first item (ID#1), you will see that the image field contains the folders and the image file name.  The reason why the plugin requires you to set the base, is to try and reduce the amount of data stored in the plugin.

  For example;  Let's say you uploaded all your shop images to your own host (in this case "yourdomain.com"), and didn't use any folders.  The "Image Base" value would be "http://yourdomain.com/", and the image field for each item would be the file name (i.e "myshopitem1.png").
 

---

 

Plugin Install / Download

To use the Shop plugin, you will need the following plugins installed before this plugin, otherwise the Shop will not work.

Yootil Library
Monetary System

Please follow the instructions in those topics.

----

Install: Monetary System - Shop

Note: Please check which version you are installing is the latest. You can do that my checking this topic title, as it contains the version number as well as the date it was released.

---

 

Integrating Into Custom Profile & Mini Profile Templates

If you need to display the profile items in a different place, then you can use an element with the id "monetary_shop_items".

if you need to display the items in the mini profile somewhere else, then you can use an element with the class name of "monetary_shop_items".

---

 

Adding The "Shop" Link To The Navigation

The URL for the shop needs to be "/?monetaryshop". Here is a video showing me adding it.

---

Screen Shots

---

 

Plugin Source

github.com/PopThosePringles/ProBoards-Monetary-System/tree/0.8/modules/shop

---

 

Plugin Changes

Here, I will attempt to keep this up to date of what things have been changed so people don't need to look through all the new posts.


Date is UK format.

0.5.7 [25/11/2015]
- Basic events for other developers.

0.5.6 [29/09/2015]
- Fixed missing expressions.

0.5.5 [25/08/2015]
- Code is now compressed due to reaching the limit.

0.5.4 [15/08/2015]
- Added in new notification calls.

0.5.3 [19/03/2015]
- Fixed an issue with hidden items in random items not checking out due to the "hidden" check (thanks @greedsins ).
- Random items can now pull from a category (new field "Use Category ID").
- Random items now can have multiple pools to look up, no longer locked to 1 type.
- Pools now get checked if the items exist, if they don't, then the random item will not appear in the shop.
- Fixed potential issue if the max price is lower that the min price. Check in place to see if it's bigger, if not, match min price.
- Improvements to make sure that if an item is marked as "hidden", then it checks the random pool to see if it can still be bought.

0.5.2 [10/03/2015]
- Added in more text replacements that were in place, just never in the admin area.
- Fixed a bug where staff couldn't remove items from profiles (thanks Shinobi ).

0.5.1 [08/03/2015]
- Random items. You can now add random items in the plugin admin area.
- Removing items from a profile now allows you to choose how many to remove.
- Add to cart now has a quantity drop down, this is optional and turned off by default.
- Changes to setup in the way it checks "boolean" settings.
- Added in basic message to the user if the key data is too big. Checks were in place, just not informing the user.
- Added quantity drop down to search tab as well.

0.5.0 [22/12/2014]
- Show / hide item on shop page
- Staff can remove their own items
- Category descriptions
- Trading / Gifting
- Bug fixes

0.4.2 [27/06/2014]
- Image settings for width and height now uses max-width and max-height

0.4.1 [26/06/2014]
- Fixed 25% discount not showing

0.4.0 [26/06/2014]
- Items can now be discounted (items show discount ribbon)
- Removing an item from a profile now possible (disabled by default; staff only feature)
- Image size setting is now applied to the shop page and dialog (checkout)
- Can now restrict the total amount a member can buy of one item
- Various tweaks and small bit of rewriting.

0.3.1 [19/06/2014]
- Fixed an issue with ID's when parsing

0.3.0 [18/06/2014]
- Image resize settings for profile and settings for mini profile
- Showing items in the mini profile
- Support for custom templates (use class "monetary_shop_items")
- Small tweaks and fixes

0.2.0 [16/06/2014]
- Can view item information on other members profiles when click on an item.
- Money updates on profile and wallet (if exists) when refunding.
- When item is refunded, image now fades out instead of just being removed quickly.
- Gift codes for items so you can give away items for free from the shop.

0.1.0 [12/06/2014]
- Alpha release

[David Clark]

IT'S ABOUT TO GO DOWN

[Peter]

I need to go put my feet up now, a lot of work preparing for a first release

[Peter]

Thanks David Clark

Install directly from the library: www.proboards.com/library/plugins/item/708

Important: You will need to grab 0.7.7 of the Monetary System (contains a few changes needed by the Shop)

[Former Member]

So much awesomeness! Yes, Peter, you deserve a break. Thank you so much for pushing the shop for release today. *dances* Off to go play with it.

[Peter]

Thanks

Don't forget to review and rate the plugin in the library.

More features will come in 0.2.0

[Former Member]

Thanks for the reminder! I had meant to do that, but I was so excited to see how everything worked with the new plugin that I forgot to do so. Oops! That is now remedied. ;D

[Former Member]

It looks awesome! Im setting it up now. Just a quick question. Will you be adding a size limit to the shop so all the images can be set to the same relative size? I have shop images that are sort of all over the place in size and it would really help!

If not just maybe a hint on what would be the right size to make them all?

Thanks Peter!

[Peter]

@greedsins,

I suppose I could add in an option for you to set the size (width and height, and percentage)?

Problem is, all it will do is reduce the size, not make them all the same size.

I could allow the box around the image to be set instead? You could do that with CSS.

Best size would be something like the badges on the profile page here.

[Peter]

 

One feature coming in 0.2.0 is gift codes (similar to the money gift codes).

[leif]

Sweet and kickass!

[Former Member]

Jun 13, 2014 0:24:22 GMT -8 Peter said:

@greedsins,

I suppose I could add in an option for you to set the size (width and height, and percentage)?

Problem is, all it will do is reduce the size, not make them all the same size.

I could allow the box around the image to be set instead? You could do that with CSS.

Best size would be something like the badges on the profile page here.

If you could that would be awesome! I tried to resize them myself but they look awful.

No need to rush! Any help would be most appreciated! Youre the best!

[mrdoe]

Hi Peter!
I have installed the Shop, but I am unable to use it as I can only use version 0.7.2 of the Monetary System, I'm including a link to a 30 second clip I made that shows the problem, I am doing this on a test
account because I thought one of my other plugins on my real forum was conflicting, so I only have yootl and monetary on the test one, same problem though. any advice/help would be great!
thanks Peter
www.youtube.com/watch?v=A8Mkm8aoqF0

[Peter]

mrdoe,

Yeah, while developing the shop, I noticed a bug with the editing money side of things, and I tried to squash it by preventing negative money.

Are you basically saying that you want to be able to set negative money for a member?

If so, I don't see a reason why it can't be allowed. I would have to look into it and maybe make it an option.

[Peter]

Jun 13, 2014 7:44:36 GMT -8 @greedsins said:

Jun 13, 2014 0:24:22 GMT -8 Peter said:

@greedsins,

I suppose I could add in an option for you to set the size (width and height, and percentage)?

Problem is, all it will do is reduce the size, not make them all the same size.

I could allow the box around the image to be set instead? You could do that with CSS.

Best size would be something like the badges on the profile page here.

If you could that would be awesome! I tried to resize them myself but they look awful.

No need to rush! Any help would be most appreciated! Youre the best!

You can modify the boxes that surround the image with CSS, though if adding in some size options would be easier, then I'll try and do that for 0.2 (hopefully released over the weekend).