Talk:World of Warcraft API

From Wowpedia
Jump to: navigation, search

This is the talk page for discussing improvements to the World of Warcraft API article.

Archived talk

Getting Started

How do I get started with mod development? In particular, there are some simple mods I'd just like to maintain - do bug fixes to keep them running in future patches. I've tried at least a couple tutorials over the last few years I've been in WoW, and either they didn't work because they were too difficult for a beginner, or maybe because they were outdated. I noticed that UI beginner's guide seems to have suffered the same fate. Does anyone have suggestions for me? Much appreciated. -Howbizr (talk) 20:46, 9 February 2009 (UTC)

Getting started with writing addons is a possible alternative. -- foxlit (talk) 16:58, 2 March 2009 (UTC)
WoW Programming is a great resource. However, even though it will be very challenging at first, trial and error (along with the book and other addons as reference) is the most effective way to learn. Start by writing small addons from scratch and work your way up. --Demeth (talk) 00:52, 5 March 2009 (UTC)

On keeping the list current

I've recently removed a few (larger) groups of functions from the list -- GetPlayerBuff* family and Crafting functions. The intention behind that is to keep this list relatively limited to things that are useful to (current) addon authors.

Granted, people may actually want information about older API functions. The removal process gets the articles tagged with {{removedapi}}, and places them in Category:World of Warcraft API/Removed Functions -- so they're still around in case people actually need them. I draw the "useful to current authors" line at the previous major patch: so API removed in 3.1 stays on this page at least until 3.2 is released, and so on.

It's my intention (unless someone objects) to remove other older removed API functions from this page as well. -- foxlit (talk) 13:48, 28 May 2009 (UTC)

In retrospect, major patches are a bit infrequent; perhaps something like a month since the release of the patch removing a function would be more appropriate.
I guess this is the best current practice for handling removed functions (aka: prefix them with "REMOVED" for around a month and afterwards remove them from the list here). I took the liberty to note this for the REMOVED-keyword on the page. --Luke1410 (talk) 22:50, 2 September 2012 (UTC)
I also dislike the presence of things like CameraOrSelectOrMoveStart here -- while those are technically part of the API, they are close to useless as far as addon authors are concerned. It would perhaps be better to split the entire "always protected" category of functions to a different page. Maintenance nightmare, though. -- foxlit (talk) 02:26, March 14, 2010 (UTC)
Protected functions should not be removed from the list as authors may want to post-hook them using hooksecurefunc and would need to know what gets passed to them and when. Posted by: EGingell (T|C|F) on 04:37, March 14, 2010 (UTC)

Verb in description

What person must be used in the verb with which the description start? Some verbs end in -s (3rd person singular) and some verb don't. What choice will be made? Hans Kamp (talk) 22:44, October 7, 2009 (UTC)

Those that are not 3rd person singular (IT DOES a thing) should be 2nd person singular (YOU use it to DO a thing). I prefer third person but either seems fine; if you can't decide, go with whatever other functions in that section use. - Jerodast (talk) 08:55, 1 January 2014 (UTC)

Minor Edits

Edited PickupBagFromSlot(slotID) and removed "If an item is already picked up, this places the item into the specified slot, swapping the items if needed." Upon testing this doesn't swap bags, use EquipCursorItem(slotID) to swap bags. BrknSoul (talk) 01:44, October 30, 2009 (UTC)

Cleanup

Would anybody object to me taking all the subsections out and putting them into their own articles? Posted by: EGingell (T|C|F) on 10:06, March 4, 2010 (UTC)

Yes. There would appear to be no reason to do so. -- foxlit (talk) 20:11, March 5, 2010 (UTC)
I was thinking a good reason would be to make the main article smaller, but if nobody else has a problem with the load time, I won't worry about it. Posted by: EGingell (T|C|F) on 22:02, March 5, 2010 (UTC)
As an all-text web page, load time should hopefully not be a problem. In any case it is extremely useful for programmers to have this page open with all functions at once so they can Ctrl-F-search different functions from various sections as necessary. Having to go through the site search functionality - THAT is load time I don't want to deal with :) - Jerodast (talk) 08:59, 1 January 2014 (UTC)

Adding API Functions

I have seen a number of API Functions that are currently missing from this page. How do I go about adding these? Can I simply edit the page, or are these pulled in from some other page? EWOlson (talk) 23:15, 28 November 2010 (UTC)

Yes, just edit it. The content here is completely put together by users. The same applies for CVars and Macro API by the way. Silverwind (talk) 23:20, 28 November 2010 (UTC)
What about adding an entire new section? Like Archaeology. Do I just add it in alphabetical order and move the others down?EWOlson (talk) 00:04, 29 November 2010 (UTC)
I don't know the answer...but don't hesitate to add a new section wherever you feel it is most appropriate. Be bold. If someone else feels there is a better spot for it, they will help out and move it for you. D.D. Corkum (T / C) 00:30, 29 November 2010 (UTC)
OK, thank you. If I get in trouble I'm blaming you. lol EWOlson (talk) 00:37, 29 November 2010 (UTC)

Use of {{api}} template

foxlit clued me into the benefits of using {{api}} on function pages, but I don't see it in use here at all. Is there any reason for that? If not I plan to replace the clunky [[API functionNameIsSoLooong|functionNameIsSoLooong]] with the sleek template throughout the entire listing.

- Jerodast (talk) 10:11, 1 January 2014 (UTC)

This page is somewhat intentionally avoiding that template -- there's a lot of API links here; replacing them all with template calls would significantly increase the amount of time the wiki requires to produce the HTML output for this article. For the time being, it's probably better to let the current syntax stay as it is. Perhaps we could eventually get a bot to automatically generate the content of this page (which would make the inconvenient syntax irrelevant), or drop the API prefix from API articles (which would make the duplication unnecessary). — foxlit (talk) 21:41, 3 January 2014 (UTC)
Aha, well you've put the lie to my claim above that "being an all text article" makes load time insignificant :) Thanks for explanation - jerodast (talk) 16:24, 9 January 2014 (UTC)

WTF?

Index Error.png

Everything between "Group" and "Pet Battle" has been deleted. That can't be good.Mltco78dhs (talk) 07:29, 26 March 2019 (UTC)

Horrible horrible mistake, it was. Ketho (talk) 10:24, 26 March 2019 (UTC)
Whew! Grateful I am (since we're apparently using Yoda-speak now -grin-). Thanks for fixing it. Mltco78dhs (talk) 12:39, 26 March 2019 (UTC)
Thanks for your vigilance :D Xporc (talk) 13:57, 27 March 2019 (UTC)