Download
(5 Kb)
Download
Updated: 08/11/19 10:12 PM
Compatibility:
Blackwood (7.0.5)
Updated:08/11/19 10:12 PM
Created:07/22/18 07:25 PM
Monthly downloads:3,278
Total downloads:562,957
Favorites:473
MD5:
LibFeedback  Popular! (More than 5000 hits)
Version: 1.32
by: Dolgubon [More]
This is a library which allows Addon Authors to easily add a feedback window to their addon. The feedback options are pretty open ended. You can do a simple 'Send Note', for if the user wants to just send you a note, a gold amount, a Paypal URL/personal website/charity donation page. If you'd like to have more options, let me know. (Or be like Baertram and code them yourself )

Usage:


local LibFeedback = LibStub:GetLibrary('LibFeedback')
-- The button is returned so you can modify the button if needed
-- ExampleAddonNameSpace.feedbackButton = LibFeedback:initializeFeedbackWindow(
ExampleAddonNameSpace, -- namespace of the addon
"Example Addon", -- The title string for the feedback window and the mails it sends
parentControl, -- The parent control to anchor the feedback button(s) + label(s) to
"@AddonAuthor", -- If this parameter is no table: [1st parameter] like desribed below:
-- The destination for feedback (0 gold attachment) and donation mails, valid for all servers
-- If this parameter is a table:
-- Example: { addonVars.addonAuthorDisplayNameEU, addonVars.addonAuthorDisplayNameNA, addonVars.addonAuthorDisplayNamePTS },
-- [1st parameter]Addon author name or character name at the EU Megaserver
-- [2nd parameter]Addon author name or character name at the NA Megaserver
-- [3rd parameter]Addon author name or character name at the PTS (Testserver)
{TOPLEFT, owningWindow, TOPLEFT, x, y}, -- The position of the mail button icon. owningWindow: Parent control for the button. x and y: Integer values for the offsets
{0,5000,50000, "https://www.genericexampleurl.com/somemoregenericiness"} -- The button info:
-- Can theoretically do any number of options, it *should* handle them
-- If this parameter is no table: [1st parameter] like desribed below:
-- If 0: Will not attach any gold, and will say 'Send Note'
-- If non zero: Will auto attach that amount of gold
-- If URL: Will show a dialog box and ask the user if they want to go to the URL.
-- If this parameter is a table:
-- Example: [index]= {[1st parameter] [2nd parameter] [3rd parameter] },
-- [1] = { 0, localization.feedbackSendNote, false }, -- Send ingame mail
-- [2] = { 10000, localization.feedbackSendGold, true }, -- Send 10000 gold
-- [3] = { addonVars.authorPortal, localization.feedbackOpenAddonAuthorWebsite, false }, -- Open URL
-- [4] = { addonVars.FAQwebsite, localization.feedbackOpenAddonFAQ, false } -- Open URL
-- [1st parameter]Integer. When >0: Gold value to send/Integer. Gold will only be send if 3rd parameter is true. / When Integer==0: Show the 2nd parameter string as button text and send ingame mail. / When String <> "": Show the 2nd parameter string as button text and open the URL from 1st parameter in Webbrowser
-- [2nd parameter]String to show as button text.
-- [3rd parameter]Boolean send gold. True: Send mail with attached gold value from 1st parameter/False: Send normal mail without gold attached


"If you found a bug, have a request or a suggestion, or simply wish to donate, send a mail.", -- Will be displayed as a message below the title.
600, -- The default width of the feedback window. If more than 4 buttons this should be increased.
150 -- The default height of the feedback window
150, -- The default width of the feedback window's buttons
28 -- The default height of the feedback window's buttons
)


Addons currently using the library:
Dolgubon's Lazy Writ Crafter

Dolgubon's Lazy Set Crafter


This Library is based on code from Master Merchant.
Version 1.32:

Removed the dependency on LibStub

Version 1.31:

Fixed a slight bug with the function button type. The text will now properly show up, and clicking on it will run the function.

Version 1.3:

API bump
Added the ability for buttons to run a function
Will play nicer when it's as a standalone addon.

Version 1.21:

Fixed a bug with setting the window height
Changed the anchor of the buttons to use BOTTOMLEFT, and a small spacer value, so different button widths don't mess up the placement

Version 1.2:

Fixed the button spacing formula
Auto resizing of the window based on # of buttons now uses the button width and not the height of the window
Window resizing properly affects button and message placement

Version 1.1: (reupload)

Added a text file so that minion will recognize it

Version 1.1:

Contributions from Baetram: (Thanks!)
- Support for different destinations for mail on different servers
- Default values and error messages added
- More options available for the buttons and windows, but still backwards compatible
- Support for translations
- Debug messages added
- Detailed description of parameters

Contributions from me
- Closes itself if the user chooses to send a mail

Version 1.0:

Initial release
Optional Files (0)


Archived Files (7)
File Name
Version
Size
Uploader
Date
1.31
5kB
Dolgubon
08/11/19 09:59 PM
1.3
5kB
Dolgubon
08/11/19 08:23 PM
1.21
5kB
Dolgubon
02/10/19 11:15 AM
1.2
5kB
Dolgubon
02/09/19 10:09 PM
1.1
5kB
Dolgubon
09/01/18 10:32 PM
1.1
4kB
Dolgubon
07/23/18 09:56 PM
0.1
44kB
07/22/18 07:25 PM


Post A Reply Comment Options
Unread 05/14/20, 07:52 PM  
Dolgubon
 
Dolgubon's Avatar
AddOn Author - Click to view AddOns

Forum posts: 408
File comments: 883
Uploads: 21
> Out of dage, and Loe´s Dolmen Runner depends on this one.

Just check the allow out of date addons box.
Report comment to moderator  
Reply With Quote
Unread 05/12/20, 12:17 PM  
Gargamella

Forum posts: 3
File comments: 2
Uploads: 0
Out of dage, and Loe´s Dolmen Runner depends on this one.
Report comment to moderator  
Reply With Quote
Unread 04/20/20, 03:10 AM  
Gandalf
 
Gandalf's Avatar
AddOn Author - Click to view AddOns

Forum posts: 28
File comments: 105
Uploads: 1
non-LibStub Library Issue

Hello,

The usage of the latest version is little bit tricky for addon authors that got rid of libstub.

Older addons which work perfectly fine and are loved and used, may have bundled older (libstub) versions of LibFeedback.

If the latest version of LibFeedback(1.32) is not installed, but older versions (which depend on libStub) are,
ESO will show LibFeedback as properly installed.
This will cause addons depending on the new (non-libstub) version to fail and authors and users being puzzled.

This can be avoided by doing two things:

1) The "## AddOnVersion:" clause needs to be added to LibFeedback's manifest. E.g:
Code:
## AddOnVersion: 132
2) Addon authors using the latest non-libstub version need to be specific in the their addon manifest (.txt):
Code:
## DependsOn: … LibFeedback>=132
This will notify the user when a never version of LibFeedback is needed and prevent the addon from loading.

You may want to do this change and point it out in the Usage section.

Cheers,
Gandalf
Last edited by Gandalf : 04/20/20 at 03:22 AM.
Report comment to moderator  
Reply With Quote
Unread 01/12/20, 04:15 AM  
effectiw

Forum posts: 0
File comments: 1
Uploads: 0
Dependency LibFeedback

Sometimes I get dependency on libfeedback addon. It's not listed in addons or libs sections of UI, but I have it in my folder.
No one but me has this bug. My guess it's related to my system language is not being English.
Last edited by effectiw : 01/12/20 at 04:16 AM.
Report comment to moderator  
Reply With Quote
Unread 12/21/19, 03:05 AM  
Onigar
 
Onigar's Avatar
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 361
Uploads: 4
Re: Please tag as library

Originally Posted by Isildra
Tnx for the awesome work so long.

Could you please add the

## IsLibrary: true

on occasion?

Makes the Addon window ingame a little more cleaned up. Tnx a lot.
I was just going to comment on this and also have now learnt what is needed to identify a library correctly.

I agree it would make the list cleaner in game, with the many addons I have atm there are 2 or 3 libs mixed in with them rather than separately listed with the Libs.
Report comment to moderator  
Reply With Quote
Unread 05/24/19, 07:53 AM  
Isildra

Forum posts: 0
File comments: 4
Uploads: 0
Please tag as library

Tnx for the awesome work so long.

Could you please add the

## IsLibrary: true

on occasion?

Makes the Addon window ingame a little more cleaned up. Tnx a lot.
Report comment to moderator  
Reply With Quote
Unread 02/05/19, 09:06 PM  
Cardinal05
AddOn Author - Click to view AddOns

Forum posts: 33
File comments: 451
Uploads: 10
Thank you for the library, Dol!

Just added this library to my housing add-on -- it was easy to use and quick to set up. Love it -- thank you so much, D!
Report comment to moderator  
Reply With Quote
Unread 09/08/18, 12:50 AM  
Dolgubon
 
Dolgubon's Avatar
AddOn Author - Click to view AddOns

Forum posts: 408
File comments: 883
Uploads: 21
Originally Posted by Marazota
i was curious why i cant find LibFeedback in minion
but i need space between words

you may want to rename it to be consistent with all other libs
they all havent space in title

Cheers!
Thanks for the heads-up. I've removed the space so it should be easier to find.
Report comment to moderator  
Reply With Quote
Unread 09/04/18, 08:46 AM  
Marazota
AddOn Author - Click to view AddOns

Forum posts: 257
File comments: 1517
Uploads: 2
i was curious why i cant find LibFeedback in minion
but i need space between words

you may want to rename it to be consistent with all other libs
they all havent space in title

Cheers!
Report comment to moderator  
Reply With Quote
Unread 09/02/18, 06:32 AM  
Baertram
Super Moderator
 
Baertram's Avatar
ESOUI Super Moderator
AddOn Author - Click to view AddOns

Forum posts: 4903
File comments: 5974
Uploads: 78
Thanks!
Report comment to moderator  
Reply With Quote
Unread 08/30/18, 11:33 AM  
Baertram
Super Moderator
 
Baertram's Avatar
ESOUI Super Moderator
AddOn Author - Click to view AddOns

Forum posts: 4903
File comments: 5974
Uploads: 78
LibFeedback won't be found on Minion. Please add the txt file!

Just wanted to provide you the contents of a LibFeedback.txt file for the dependency to LibStub:
Code:
## Title: LibFeedback
## Author: Dolgubon
## APIVersion: 100024 100025
## Version: 1.1
## Description: This is a library which allows Addon Authors to easily add a feedback window to their addon
## DependsOn: LibStub

## This Add-On is not created by, affiliated with or sponsored by ZeniMax Media Inc. or its affiliates. The Elder Scrolls® and related logos are registered trademarks or trademarks of ZeniMax Media Inc. in the United States and/or other countries. All rights reserved.

libs/LibStub.lua
feedback.lua
I've build a package zip for version 1.1 too including libstub so one can add this lib as standalone too:
LibFeedback v1.1 with LibStub
Last edited by Baertram : 09/01/18 at 04:37 PM.
Report comment to moderator  
Reply With Quote
Unread 07/23/18, 04:13 AM  
Baertram
Super Moderator
 
Baertram's Avatar
ESOUI Super Moderator
AddOn Author - Click to view AddOns

Forum posts: 4903
File comments: 5974
Uploads: 78
Thanks Dolgubon, looks promising.
Will try to add it to an addon and check what nonsense ppl will use it for

Edit:
The description is missing the 3rd parameter "parentControl" for the function
LibFeedback:initializeFeedbackWindow(parentAddonNameSpace, parentAddonName, parentControl, mailDestination, mailButtonPosition, buttonInfo, messageText)

Ideas/Questions:
Are we somehow able to specify different @names for the mail attachments, depending on the server name?

And I got some more ideas, will work on them some time I guess and send you an example then.
e.g.
-Change the texture + size + color of the mail icon from function parameters/via a library function (as addition to returning the button as a variable and chaning it afterwards)
-Change the text shown on the buttons
-Preset the text shown in the mail body
...

Edit2:
Added a pull request to github with my changes.
Last edited by Baertram : 07/23/18 at 11:22 AM.
Report comment to moderator  
Reply With Quote
Unread 07/22/18, 09:17 PM  
Dolgubon
 
Dolgubon's Avatar
AddOn Author - Click to view AddOns

Forum posts: 408
File comments: 883
Uploads: 21
Originally Posted by Architecture
Nice job Dolg! I'll try this out Cool concept
Hope you like it! I've had it for some time, but just got around to releasing it.
Report comment to moderator  
Reply With Quote
Unread 07/22/18, 07:53 PM  
Architecture
 
Architecture's Avatar
AddOn Author - Click to view AddOns

Forum posts: 7
File comments: 79
Uploads: 8
Nice job Dolg! I'll try this out Cool concept
Report comment to moderator  
Reply With Quote
Post A Reply



Category Jump:

Support AddOn Development!

You have just downloaded by the author . If you like this AddOn why not consider supporting the author? This author has set up a donation account. Donations ensure that authors can continue to develop useful tools for everyone.