ManiaLib, a lightweight & simple PHP framework for Manialink

If you have anything to say - or advice to give - on the creation or publishing of ManiaLinks, here is the place to do it!

Moderator: TM-Patrol

gou1
cyclist
cyclist
Posts: 49
Joined: 29 Dec 2008 10:25
Owned TM-games: TMO,TMUF
Manialink(s): manialib maniapub maniateam

ManiaLib, a lightweight & simple PHP framework for Manialink

Post by gou1 » 06 Jul 2009 14:26

Edit: November 15th, 2010
ManiaLib 1.0 beta was release, check post #14
/Edit


Hello everyone,

My mission at Nadeo was to develop the ManiaTeam game mode. I therefore developped a set of small but pratical libraries to help creating and maintaining Manialinks. In the end, we decided with the team that the project should be given back to the community as an open source project. There was born ManiaLib, a lighweight and simple developpement framework, written in PHP, for the creation of Manialinks. Even if it comes with basic modules, it isn't an all inclusive solution. It is a set of "building bricks" for PHP developpers.

I invite you all Manialink creators to use this framework. Your precious feedback will help the project to improve.

It is hosted on Google Code, where you can get the source code and some documentation:
I've already written tutorials about the core APIs so that you get rapidly confortable with the basics of ManiaLib. These are the available APIs:
  • GUI : classes for creating Manialink graphical elements
    DatabaseEngine : database abstraction layer
    RequestEngine : handling of GET variables and referers, creation of links and redirections
    SessionEngine : manipulation des variables de session
    LangEngine : internationalization
    MultipageList : page numbering helper
Some basic modules are also provided to help developpers making other modules:
  • Admin: secure authentication to make admin panels
    Posts: generic content management
    Auto Connect: forced user identification
The ideal working condition is to use an IDE (Integrated Dev Environment). I personnaly use PHPEclipse plugin for Eclipse, which provides code assist, code completion etc. For those of you who use plain text editors, I made a "cheat sheet": a wallpaper with a reminder of all the core classes with their public methods and properties.
There are two way to get the source code. You can either download the latest release from the project's website - this is the simplier - or you can checkout the latest revision from the SVN repository - if you now SVN, this is the ideal, checkout from trunk/manialib-example.
You can see the demo Manialink here : ManiaLibcolor>
Don't hesitate to post any feedback in this thread.

Max :lovetm
Last edited by gou1 on 15 Nov 2010 15:59, edited 1 time in total.

User avatar
TheM
Pit Crew
Pit Crew
Posts: 286
Joined: 25 Feb 2009 16:43
Owned TM-games: TMU(F), TMN(F), TM2
Location: Brabant, Netherlands
Contact:

Re: ManiaLib, a lightweight & simple PHP framework for Manialink

Post by TheM » 06 Jul 2009 14:59

Nice one! :1010

jouko100
speedy pilot
speedy pilot
Posts: 375
Joined: 10 Mar 2007 09:33
Location: finland
Contact:

Re: ManiaLib, a lightweight & simple PHP framework for Manialink

Post by jouko100 » 06 Jul 2009 17:00

manialinks are difficult but this looks more..................

User avatar
TStarGermany
speedy pilot
speedy pilot
Posts: 387
Joined: 27 Aug 2006 18:12
Owned TM-games: TMN,TMNF,TMUF
Manialink(s): creative
Location: GER
Contact:

Re: ManiaLib, a lightweight & simple PHP framework for Manialink

Post by TStarGermany » 06 Jul 2009 17:06

that looks promising, well done :lovetm
Image

gou1
cyclist
cyclist
Posts: 49
Joined: 29 Dec 2008 10:25
Owned TM-games: TMO,TMUF
Manialink(s): manialib maniapub maniateam

Re: ManiaLib, a lightweight & simple PHP framework for Manialink

Post by gou1 » 06 Jul 2009 17:18

jouko100 wrote:manialinks are difficult but this looks more..................
Obviously this is not a tool for Manialinks beginners. It is meant for developpers who already know Manialinks and PHP and who want to save time and effort on development.

User avatar
Generator
speedy pilot
speedy pilot
Posts: 339
Joined: 18 Apr 2008 00:35
Owned TM-games: TMNF - TMUF
Manialink(s): Generator
Location: Lancashire, England
Contact:

Re: ManiaLib, a lightweight & simple PHP framework for Manialink

Post by Generator » 06 Jul 2009 17:51

gou1 wrote:
jouko100 wrote:manialinks are difficult but this looks more..................
Obviously this is not a tool for Manialinks beginners. It is meant for developpers who already know Manialinks and PHP and who want to save time and effort on development.
So why do you recommend an IDE? (just curious thats all, if it's not for beginners..)
Has it got mega-complicated API or something?

Well done, btw! :thumbsup:
Customize your virtual world to the max! >> http://www.virtualcustoms.net
3D Models, 2D skins & horns on my Manialink >> Generatorcolor>

gou1
cyclist
cyclist
Posts: 49
Joined: 29 Dec 2008 10:25
Owned TM-games: TMO,TMUF
Manialink(s): manialib maniapub maniateam

Re: ManiaLib, a lightweight & simple PHP framework for Manialink

Post by gou1 » 07 Jul 2009 08:39

Generator wrote: So why do you recommend an IDE? (just curious thats all, if it's not for beginners..)
Has it got mega-complicated API or something?
Actually the APIs are really simple. When I say it is not for beginner, I mean that someone who never wrote a line of code may want to start with learning XML, then PHP. You still have to know what a class or an object are for instance, which may not be obvious at first.

About the IDE, I recommend it because it has the same goal as a framework : make you save a great deal of time and effort by providing useful tools. For example: PHP parser, which tells you in real time when you forgot a semi-colon or when you type the wrong variable name, code completion, code navigation (CTRL+click on a function or a class opens its declaration), debugging and much more. It is for sure more complicated to install and configure and learn, but the time you take to do that will be soon enough saved back.

Gekko
speedy pilot
speedy pilot
Posts: 550
Joined: 03 Sep 2006 18:20
Owned TM-games: ALL
Location: Naples - Italy
Contact:

Re: ManiaLib, a lightweight & simple PHP framework for Manialink

Post by Gekko » 07 Jul 2009 22:54

Great work gou1!!!

I will take a look, if i can help call me, i have much experience with ingame manialinks creations.

Greetings.

User avatar
apovtx
happy cruiser
happy cruiser
Posts: 154
Joined: 04 Dec 2008 16:06
Owned TM-games: TMUF,TMNF,TMN
Manialink(s): funteam
Location: Xanthi,Greece
Contact:

Re: ManiaLib, a lightweight & simple PHP framework for Manialink

Post by apovtx » 25 Jul 2009 10:01

Hi, very nice work :thumbsup:
Have you got any working examble to start "playing" with?

Thanks Ap0VTx

:thumbsup: :lovetm
Do you wanna be a journalist?
Contact me with PM!
Image

gou1
cyclist
cyclist
Posts: 49
Joined: 29 Dec 2008 10:25
Owned TM-games: TMO,TMUF
Manialink(s): manialib maniapub maniateam

Re: ManiaLib, a lightweight & simple PHP framework for Manialink

Post by gou1 » 27 Jul 2009 10:29

apovtx wrote:Have you got any working examble to start "playing" with?
The archive actually is an application example.

User avatar
apovtx
happy cruiser
happy cruiser
Posts: 154
Joined: 04 Dec 2008 16:06
Owned TM-games: TMUF,TMNF,TMN
Manialink(s): funteam
Location: Xanthi,Greece
Contact:

Re: ManiaLib, a lightweight & simple PHP framework for Manialink

Post by apovtx » 27 Jul 2009 10:59

Yes thank you i finally understood how it works some hours after the post :oops:

I have already started to turn my team's manialink funteamcolor> with the script (offline yet!)

:thumbsup: :lovetm Apovtx



*EDIT*:Is there a way to change the "sizen" or the "posn" to "size" and "pos"? (I fount it finally) :D
Do you wanna be a journalist?
Contact me with PM!
Image

gou1
cyclist
cyclist
Posts: 49
Joined: 29 Dec 2008 10:25
Owned TM-games: TMO,TMUF
Manialink(s): manialib maniapub maniateam

Re: ManiaLib, a lightweight & simple PHP framework for Manialink

Post by gou1 » 28 Jul 2009 13:18

apovtx wrote:]Is there a way to change the "sizen" or the "posn" to "size" and "pos"? (I fount it finally) :D
There's no built-in feature to do that. I strongly recommend using posn and sizen since it's the newest positioning system.

Edit: nice article about that: http://funtrackers.bplaced.net/forum/sh ... 3#posarten

You could hack the code of the gui api, but I guess it would be a bit tricky to get all things working well.

User avatar
apovtx
happy cruiser
happy cruiser
Posts: 154
Joined: 04 Dec 2008 16:06
Owned TM-games: TMUF,TMNF,TMN
Manialink(s): funteam
Location: Xanthi,Greece
Contact:

Re: ManiaLib, a lightweight & simple PHP framework for Manialink

Post by apovtx » 28 Jul 2009 13:58

Thank you for your reply.

I found how to change but then a realize that all the gui api had to change as well so i turned it back to original. I know the "...n" system but the whole manialink is written in the other form so it would be more complicated to change it.

Anyway i will re-write the whole manialink with the manialib

Thanks
:thumbsup: :lovetm Apovtx
Do you wanna be a journalist?
Contact me with PM!
Image

gou1
cyclist
cyclist
Posts: 49
Joined: 29 Dec 2008 10:25
Owned TM-games: TMO,TMUF
Manialink(s): manialib maniapub maniateam

Re: ManiaLib, a lightweight & simple PHP framework for Mania

Post by gou1 » 15 Nov 2010 15:58

Hi,

Today we are releasing ManiaLib 1.0 beta !

Why a beta? While the code is stable, the documentation is still light, therefore the package is better made for experienced developers.

You just need to download the package, unzip it, and follow the instructions of the Readme.

To get the latest version: http://manialib.com

To see the API reference: http://api.manialib.com

To see the demo manialink: ManiaLibcolor>

Have fun, and don't hesitate to give us your feedback !

jamie_macdonald
TM-Patrol
TM-Patrol
Posts: 1612
Joined: 10 Jul 2008 19:48
Owned TM-games: TMUF, TMNF, TMS
Manialink(s): ET
Location: London, UK
Contact:

Re: ManiaLib, a lightweight & simple PHP framework for Mania

Post by jamie_macdonald » 15 Nov 2010 16:09

Nice stuff! ...a bit over my head most of it but looks very handy :thumbsup:

Thx for sharing :)

Post Reply