Advertisement:

Author Topic: Function DB Version 2.0...  (Read 404577 times)

Offline Oldiesmann

  • Lead Developer
  • SMF Super Hero
  • *
  • Posts: 24,205
  • Gender: Male
  • Ask me about the function DB :)
    • oldiesmann on Facebook
    • Oldiesmann on GitHub
    • http://www.linkedin.com/in/michaeleshom on LinkedIn
    • @oldiesmann on Twitter
    • Archie Comics Fan Forum
Function DB Version 2.0...
« on: May 08, 2008, 12:18:05 AM »
Sometime last year (or possibly even in 2006), I started thinking about improvements to the function DB, and noticed one major issue: due to the way the data was stored, we had to add an entire new function entry if a function was moved or changed in some way (additional functionality, new parameters, etc.). This meant that the function ID would also change in these situations, making it harder to track changes to functions between SMF versions.

I decided to rewrite the function db to address this problem, and addressed a few other (smaller) issues while I was at it. Due to the changes, I had to manually copy over all the function info from the existing function db to a new one which was being worked on in a non-public area of the site. I got busy and didn't have a lot of time to work on this, so it took a lot longer than I had originally planned, but I am pleased to report that the new version is up.

At first you won't notice many changes, as things should still look the same. However, there have been numerous changes:

  • Function ID remains the same no matter what changes are made to a function (except of course if it's renamed)
  • SMF version dropdown list only shows versions that the file/function you're viewing exists in
  • Ability to switch SMF versions while viewing a file/function without being redirected to the main index
  • If documented, $context variables loaded by a function are shown on the function details page (most functions don't have any $context variables documented yet - see Admin() for an example
  • Ability to specify an SMF version in the URL to view a function or file for that version of SMF (example: .../index.php?action=view_file;id=x;smf_version=1.1.5)
  • Ability to view all versions of a function, so you can see the changes that have been made in the development process (page isn't real pretty at the moment, but I'll work on that as I have time)
  • All CSS has been moved to an external stylesheet, allowing your browser to cache it

All existing SMF functions (eg all the ones that were already in the function db) have been updated, so details exist for 2.0 as well. In addition, some functions that were added in 2.0 have already been documented (these are mainly ones that we documented from early alpha versions of 2.0).

What's to come? At this point we will be focusing mainly on documenting new functions from SMF 2.0. My goal is to have as many 2.0 functions documented as possible by the time the final version is released later this year.

I hope these changes make the function db more useful. Let me know if you run into any problems :)

Offline [SiNaN]

  • SMF Super Hero
  • *******
  • Posts: 11,519
  • Young and Foolish
    • SimplePortal
Re: Function DB Version 2.0...
« Reply #1 on: May 08, 2008, 02:19:33 AM »
Awesome. Thanks for your effort. ;)
Former SMF Core Developer | My Mods | My Anime List | SimplePortal | Samanyolu Fanları

Offline bassbass

  • Jr. Member
  • **
  • Posts: 198
  • Gender: Male
    • Greek and Turkish Clarinet
Re: Function DB Version 2.0...
« Reply #2 on: May 08, 2008, 03:35:00 AM »
Awesome. Thanks for your effort. ;)

i second that...

Offline Roph

  • Jr. Member
  • **
  • Posts: 376
  • Gender: Male
Re: Function DB Version 2.0...
« Reply #3 on: May 08, 2008, 05:20:55 AM »
Wow, I was honestly about to post a few suggestions regarding the function DB, and here you make a post implementing what I was after (comparison, switching version and staying put and extra 2.0 info) :D

THANKYOU :D

Offline deadnewton

  • Semi-Newbie
  • *
  • Posts: 23
  • Gender: Male
Re: Function DB Version 2.0...
« Reply #4 on: May 08, 2008, 06:45:33 AM »
well i am programmingly challenged...(but good in math :) )so pardon me....
I am running 1.1.5...should I do something with this or just sit tight for v2
How many dimples are there in a golf ball?
Running SMF 1.1.4 + TP 0.9.8.
When is SMF2 gonna be out?

Offline Dragooon

  • Developer
  • SMF Hero
  • *
  • Posts: 6,484
  • Gender: Male
  • I'm batman
    • ShitizGarg on Facebook
    • Dragooon on GitHub
    • dragooon on LinkedIn
    • SMF-Media
Re: Function DB Version 2.0...
« Reply #5 on: May 08, 2008, 07:21:36 AM »
I think you misunderstood what function db is.

Function DB(Located here) is a database containing all the functions which are used in SMF. So this announcement is to announce the implementation of Function DB Version 2.0, it is not a SMF release.

BTW, Great release!

Offline Dannii

  • SMF Friend
  • SMF Super Hero
  • *
  • Posts: 10,211
  • Mind the volcano!
    • My homepage
Re: Function DB Version 2.0...
« Reply #6 on: May 08, 2008, 07:30:11 AM »
You know what would be great? Being able to specify the function in the URL instead of using an ID. Any chance that's possible?
"Never imagine yourself not to be otherwise than what it might appear to others that what you were or might have been was not otherwise than what you had been would have appeared to them to be otherwise."

Offline deadnewton

  • Semi-Newbie
  • *
  • Posts: 23
  • Gender: Male
Re: Function DB Version 2.0...
« Reply #7 on: May 08, 2008, 08:37:16 AM »
I think you misunderstood what function db is.

Function DB(Located here) is a database containing all the functions which are used in SMF. So this announcement is to announce the implementation of Function DB Version 2.0, it is not a SMF release.

BTW, Great release!

Great.. Now i got it...i did not have that link with me when I posted and was thoroughly confused and thought that i need to update the functions to get....something amazing...;)
very well documented.. i should incorporate this style into my dissertation work...!
How many dimples are there in a golf ball?
Running SMF 1.1.4 + TP 0.9.8.
When is SMF2 gonna be out?

Offline Oldiesmann

  • Lead Developer
  • SMF Super Hero
  • *
  • Posts: 24,205
  • Gender: Male
  • Ask me about the function DB :)
    • oldiesmann on Facebook
    • Oldiesmann on GitHub
    • http://www.linkedin.com/in/michaeleshom on LinkedIn
    • @oldiesmann on Twitter
    • Archie Comics Fan Forum
Re: Function DB Version 2.0...
« Reply #8 on: May 08, 2008, 11:03:59 AM »
You know what would be great? Being able to specify the function in the URL instead of using an ID. Any chance that's possible?

Not possible at the moment, but that won't be too hard to implement. I'll make the changes in a little while.

Offline boranjudge

  • Semi-Newbie
  • *
  • Posts: 67
Re: Function DB Version 2.0...
« Reply #9 on: May 08, 2008, 05:39:05 PM »
Thank you ;)

Offline karlbenson

  • SMF Friend
  • SMF Super Hero
  • *
  • Posts: 15,584
  • Gender: Male
    • @mortonssols on Twitter
    • Criminal Solicitors
Re: Function DB Version 2.0...
« Reply #10 on: May 08, 2008, 05:42:33 PM »
I'd like to see some examples of each function being used.

If I'm honest. I read/understand the examples on the PHP website more than their techno-babble about the function.

Offline metallica48423

  • SMF Friend
  • SMF Super Hero
  • *
  • Posts: 19,842
  • Gender: Male
  • Professional Multislacker!
    • Zentendo
Re: Function DB Version 2.0...
« Reply #11 on: May 08, 2008, 05:57:44 PM »
its been suggested -- coming up with a way to implement it is another question.  Of course, we first need to actually finish the function entries and get things updated for 2.0
Justin O'Leary
Ex-Project Manager
Ex-Lead Support Specialist

Quote
Microsoft wants us to "Imagine life without walls"...
I say, "If there are no walls, who needs Windows?"

Useful Links:
Online Manual!
How to Help us Help you   
Search
Settings Repair Tool
     

Offline aldo

  • Sophist Member
  • *****
  • Posts: 1,356
  • Gender: Male
Re: Function DB Version 2.0...
« Reply #12 on: May 08, 2008, 06:08:02 PM »
You know what would be great? Being able to specify the function in the URL instead of using an ID. Any chance that's possible?

Not possible at the moment, but that won't be too hard to implement. I'll make the changes in a little while.
That'd be cool, kind of like PHP's site, like www.php.net/FUNCTION :D
Great job though ;)

Offline SleePy

  • Site Team
  • SMF Master
  • *
  • Posts: 28,951
  • Gender: Male
  • Thats his happy face.
    • @jdarwood on Twitter
    • SleePy Code - My personal site
Re: Function DB Version 2.0...
« Reply #13 on: May 08, 2008, 10:15:13 PM »
Well the examples isn't a bad idea, though I think the best way to do them would be from actual SMF source code like I did for the 2.0 Functions for mod authors. Seeing the actual code in use is very handy I know.
I read the tech blab to make sure I am casting things as I should and using it correctly, I also use the examples for when I don't feel like reading the tech blab and just need to make sure I am passing the correct variables to a function.
Jeremy D — Site Team / SMF Developer
Support the SMF Support team!
Profiles:
GitHub
G+

Offline TeenDev

  • Semi-Newbie
  • *
  • Posts: 11
Re: Function DB Version 2.0...
« Reply #14 on: May 08, 2008, 10:38:41 PM »
im sure this will make things a lot less confusing

Offline Minare

  • Sophist Member
  • *****
  • Posts: 1,233
  • Gender: Male
  • Yapayalnız Kalmak İskelelerde !
    • Meryemce
Re: Function DB Version 2.0...
« Reply #15 on: May 09, 2008, 02:33:53 PM »
Having no knowledge in programming or smf function db but being curious about what those changes will earn us, I request someone to tell me what those function db changes will make use of, just simply..

Examp : Forums will be faster blah blah...

Sorry  :D
O güzel Râsulu Yesrip yolunda
Hicret coşkusuyla aramalısın
Ayrılık Anne'den Baba'dan Yâr'dan
Ezelden geçerek kavuşmalısın

http://www.meryemce.biz

Online Kindred

  • The Mean One
  • Project Manager
  • SMF Master
  • *
  • Posts: 41,644
  • Gender: Male
    • wagner999 on Facebook
    • Kindred-999 on GitHub
    • www.linkedin.com/in/wdwagner/ on LinkedIn
    • @Kindred_999 on Twitter
Re: Function DB Version 2.0...
« Reply #16 on: May 09, 2008, 02:57:12 PM »
What?

Minare.... the function database has nothing at all to do with your site. It is a list of the functions used by SMF files...   specifically for those who want to build mods, bridges and implement other things using SMF functions.
Please do not PM, IM or Email me with support questions.  You will get better and faster responses in the support forums.  Thank you.

Offline Minare

  • Sophist Member
  • *****
  • Posts: 1,233
  • Gender: Male
  • Yapayalnız Kalmak İskelelerde !
    • Meryemce
Re: Function DB Version 2.0...
« Reply #17 on: May 09, 2008, 02:59:36 PM »
Hımm, I thought different, Sorry.

Thank u Kindred ;)
O güzel Râsulu Yesrip yolunda
Hicret coşkusuyla aramalısın
Ayrılık Anne'den Baba'dan Yâr'dan
Ezelden geçerek kavuşmalısın

http://www.meryemce.biz

Offline vagrant

  • Semi-Newbie
  • *
  • Posts: 72
  • Gender: Male
    • Discount Le Creuset
Re: Function DB Version 2.0...
« Reply #18 on: May 14, 2008, 07:31:46 PM »
Thanks for all the hard work Oldiesmann.

Wow you must be one BIG dedicated person.

vagrant

Offline Oldiesmann

  • Lead Developer
  • SMF Super Hero
  • *
  • Posts: 24,205
  • Gender: Male
  • Ask me about the function DB :)
    • oldiesmann on Facebook
    • Oldiesmann on GitHub
    • http://www.linkedin.com/in/michaeleshom on LinkedIn
    • @oldiesmann on Twitter
    • Archie Comics Fan Forum
Re: Function DB Version 2.0...
« Reply #19 on: May 16, 2008, 01:56:17 PM »
You're welcome :)

I actually enjoy going through SMF and documenting all the functions... That's how I find easter eggs :P