Trophies 1.0.2 - [Updated: 19th Jan, 2016]

[Peter]

This plugin is no longer available or supported.

Test the Trophies plugin here: trophies.proboards.com

Trophies Plugin

---

IMPORTANT:

    The Yootil plugin 1.1.1 or higher is required for this plugin to work. Place the Yootil plugin at the top of your plugin list.

    Yootil Plugin: www.proboards.com/library/plugins/item/38

    Trophies Plugin:  www.proboards.com/library/plugins/item/1189

---

FAQ

- There is nothing showing in mini profiles
    If you are using a custom theme or mini profile layout, then this is likely your problem.  The Trophies plugin requires the mini profile to have the class "mini-profile", and the profile link must exist in the mini profile (this can be hidden) with the class "user-link".  These are the vanilla classes, removing them is not a good idea.

- I have a custom mini profile and want to style / move the trophy information
    There is a class you can use on any element in the mini profile so that you can position the trophy information anywhere you like.

    trophies-custom-mini-profile

    Example:

    <div class="trophies-custom-mini-profile"></div>

- I have a custom profile and would like to move the trophy information
    There is an ID you can add to an element so that you can position the trophy information anywhere you like on the profile page.

    trophies-custom-profile

    Example:

    <div id="trophies-custom-profile"></div>

- Some trophies are not popping up when I am sure myself or my members have met the requirements
    Please note that some trophies are not retroactive.  So trophies that are for reading topics, following members and a few others, will only pop once the requirement has been met, as there is no existing data that the trophy plugin can look at.

    Some trophies have basic AFK protection.  For example, the time based trophies requires the use to have the window / tab focused.  They cannot open a window / tab in the background and go do other things (i.e watch YouTube, play Games).

    Trophies such as "Topics Read" have basic protection to prevent the user opening lots of topics in multiple tabs.

    If you are still sure a trophy should have popped up, please post in this topic so I can investigate.

- Me or some of my forum members have lost their trophies
    Trophies are stored locally for each user until they are synced to the account.  If the user decides to use another browser before the trophies are synced, then they will have to earn them again.
   
    Trophies are synced to the account when a user posts or sends a message.  This is due to the limitations of how plugin developers are allowed to set key data.  I may consider adding in more places to sync the data in the future.

- Why can I not see other members trophies when they have told me they earned some?
    See the above question.

- Will you add more trophies?
    The Trophies plugin is close to the limit for the amount of trophy images it can store.  However, the Trophy plugin has support for trophy packs.  So the answer is yes, though I need ideas for trophies.

- Trophy title or description doesn't really make sense, can I change it?
    Thinking up names for trophies was difficult, so I'm open to suggestions for better names and descriptions.  For the moment, no trophy can be changed in the core pack.

- Why does it say I am level X and at 100%?
    A level doesn't roll over to the next if the XP / Points are exactly the same as the level requirement.

- Can I disable the stat animations?
    Not at this time.  If people prefer not for it to "crunch" the numbers, then I will consider options.

- Can I add custom trophies?
    You sure can, however you need to know how to create a pack.  Please post and I will show you a basic example.  Warning:  programming knowledge needed.

- Can I disable a trophy?
    This was going to be an option in the first release, but decided not to include it for now.  So maybe in the future.

- Can I add / remove a trophy from a members account?
    Currently you can not.  I did think about adding support for this, but it will need to be for a future release.  If there is interest, I will consider adding it in sooner.

- Can I customise anything?
    As with nearly anything on the forum, you can modify the way things look (i.e font size, padding, margins) with CSS.

---

Custom Profiles and Mini Profiles

Example of using the custom class to modify the location of mini profile trophy information:




Example of using the custom ID to modify the location of the trophy information on the profile:

---

Screen Shots

 

---

Source

The repository also contains an example of a pack for any plugin authors wanting to add trophies to their own plugins.

github.com/PopThosePringles/ProBoards-Trophies

---

Changes

Date is UK format.

1.0.2 [19/1/2016]
- Tied local data to actual accounts so that multiple accounts can earn trophies separately.
- Added in some events to help future packs.
- Pre init check added.

1.0.1 [28/12/2015]
 - Fixed typo in trophy description.

[nekobot]

Dec 17, 2015 11:49:08 GMT -8 Peter said:

- Can I add custom trophies?
    You sure can, however you need to know how to create a pack.  Please post and I will show you a basic example.  Warning:  programming knowledge needed.

I realize you JUST posted this plugin, but whenever you have the time to explain this, I would greatly appreciate it! Thank you for your hard work! 

[Peter]

nekobot ,

Adding custom trophies isn't too difficult depending on your knowledge of JavaScript.

I would say to take a look at the test pack here and see what you understand.

github.com/PopThosePringles/ProBoards-Trophies/tree/master/Packs/Test

If your pack doesn't need to store custom pack data and can use existing data (i.e looking at a users post count), then things become extremely simple.

Example code:

if(typeof TROPHY_REGISTER == "undefined"){
TROPHY_REGISTER = {};
}

TROPHY_REGISTER["trophies_test_pack"] = {

name: "Test Pack",
description: "Test trophy pack",

plugin_id: "trophies_test_pack",
plugin_key: "trophies_test_pack",

trophies_key: "t",

trophies_data_key: "d",

"trophies": [

{

id: 1,
cup: "bronze",
title: "Post Millionaire",
image: "millionposts",
description: "Created 1 million posts",
disabled: false,
callback: function(trophy){
if(yootil.user.posts() >= 1000000){
this.show_notification(trophy);
}
}

}

]

};

That's as basic as it gets. Once you move into needing to store your own data, then things getting a little more tricky. See the test pack source on how I add a simple counter that gets saved and incremented each time. Once it hits 5, it pops the trophy.

The core pack has basic stuff like that, but also does custom data as well.

github.com/PopThosePringles/ProBoards-Trophies/blob/master/Packs/core.js

[nekobot]

Thank you!! How hard would it be to switch out the trophy images? That's more what I meant by custom trophies, but this is extremely helpful too!

[Peter]

Dec 18, 2015 5:05:46 GMT -8 nekobot said:

Thank you!! How hard would it be to switch out the trophy images? That's more what I meant by custom trophies, but this is extremely helpful too!

For the moment it wouldn't be easy.  I'll have to add events into the notification module so that you could swap them out there before the notification is inserted into the DOM.  Will still need coding knowledge to do so though.

[Boy_Wonder]

Dec 17, 2015 13:52:40 GMT -8 Peter said:

nekobot ,

Adding custom trophies isn't too difficult depending on your knowledge of JavaScript.

I would say to take a look at the test pack here and see what you understand.

github.com/PopThosePringles/ProBoards-Trophies/tree/master/Packs/Test

If your pack doesn't need to store custom pack data and can use existing data (i.e looking at a users post count), then things become extremely simple.

Example code:

TROPHY_REGISTER["trophies_test_pack"] = {

name: "Test Pack",
description: "Test trophy pack",

plugin_id: "trophies_test_pack",
plugin_key: "trophies_test_pack",

trophies_key: "t",

trophies_data_key: "d",

"trophies": [

{

id: 1,
cup: "bronze",
title: "Post Millionaire",
image: "millionposts",
description: "Created 1 million posts",
disabled: false,
callback: function(trophy){
if(yootil.user.posts() >= 1000000){
this.show_notification(trophy);
}
}

}

]

};

none related - I'm just trying to work out the wording behind the code - this bit: is it effectively a variable containing an object containing an array containing an object to build the structure up? (I'm just covering and making notes on this on what I'm using as a study aid xD)

[Boy_Wonder]

Minor bug found: Folowed 15 members.
any point you've put Followed you've typed it as Folowed

[Peter]

Boy_Wonder,

Yeah, noticed like an hour after releasing the plugin. I submitted an update the same day, just waiting for it to be approved.

[Matt]

Peter

on your trophies test forum I can see the profile tab, I added the trophies plugin to one of my test forums and the profile tab is not showing. what should I do about this?

[Peter]

Dec 23, 2015 9:01:37 GMT -8 Matt said:

Peter

on your trophies test forum I can see the profile tab, I added the trophies plugin to one of my test forums and the profile tab is not showing. what should I do about this?

I need a forum link to at least see what's different.

[Matt]

Dec 24, 2015 6:11:36 GMT -8 Peter said:

Dec 23, 2015 9:01:37 GMT -8 Matt said:

Peter

on your trophies test forum I can see the profile tab, I added the trophies plugin to one of my test forums and the profile tab is not showing. what should I do about this?

I need a forum link to at least see what's different.

mattytestforum.proboards.com

I'll be buying more plugin space for my main forum thechattingbox.proboards.com on christmas day and then i'll be adding the trophies plugin so it doesn't really matter about the mattytestforum. I just hope everything works fine when I put it on my main forum.

[Carver]

Will you be updating this plugin every month or maybe every Holiday or Event that comes up? I was just curious because it is a good idea and I look forward to seeing more ideas being put into the Trophies and Stats. The idea of them getting Trophies for logging in on Christmas Eve and on Christmas is an excellent idea. Perhaps they can earn Trophies for getting more likes? I noticed that is not in there as I reviewed the trophies.

I'm sure you have some ideas up your sleeve and you're just testing out the Trophies to see if it goes far or not or if people really enjoy it, correct? I look forward for some more updates when you do.

[Peter]

Dec 24, 2015 7:19:02 GMT -8 Matt said:

Dec 24, 2015 6:11:36 GMT -8 Peter said:

I need a forum link to at least see what's different.

mattytestforum.proboards.com

I'll be buying more plugin space for my main forum thechattingbox.proboards.com on christmas day and then i'll be adding the trophies plugin so it doesn't really matter about the mattytestforum. I just hope everything works fine when I put it on my main forum.

Well, as you have already seen on the test forum of mine, it works fine.  How it works on your forum is anyone's guess until you actually try it.

[Peter]

Dec 24, 2015 8:47:37 GMT -8 Carver said:

Will you be updating this plugin every month or maybe every Holiday or Event that comes up? I was just curious because it is a good idea and I look forward to seeing more ideas being put into the Trophies and Stats. The idea of them getting Trophies for logging in on Christmas Eve and on Christmas is an excellent idea. Perhaps they can earn Trophies for getting more likes? I noticed that is not in there as I reviewed the trophies.

I'm sure you have some ideas up your sleeve and you're just testing out the Trophies to see if it goes far or not or if people really enjoy it, correct? I look forward for some more updates when you do.

Not sure how often I will be updating it to be honest.  I have an update waiting to be approved that fixes a typo, and will likely put out another update to make some internal changes.

As for more trophies;  The plan is to release packs.  I have a little space to squeeze a couple more into the core pack, and funny enough, it was going to be the "Like Post" kinda of trophy.  However, I'm not 100% sure what I have planned in the new year, so I don't know how active I will be working on this, as it's something I don't get paid for, nor can we sell them via the library.  Also, trophies take a while to think up, and implement.  While most of the the images are from a free icon site, I have to modify each one of them, so it's time consuming.

Thanks for the feedback though.

[Boy_Wonder]

I'm curious as to what icon site xD