Boxes Manialink easy and fast

Talk about ManiaLink development in this forum

Moderator: NADEO

htbplayer
Posts: 31
Joined: 14 Jun 2011, 15:05

Boxes Manialink easy and fast

Post by htbplayer »

Boxes
Manialinks easy and fast

Image
0. Content

1.System
1.1 Idea
1.2 Extensions
1.2.1 Boxes-Instances
1.2.2 Designs
1.2.3 StarterPacks
1.3 Multiuser
1.4 Different Gameversions
1.5 Different Languages

2.Installation
2.1 Systemrequirements
2.2 Instruction
2.3 First Steps
2.4 Installation of Extensions

3.Use
3.1 On-Manialink administration
3.1.1 Boxbar
3.1.2 Quickbar
3.2 Uploads
3.3 Settings
3.4 Updates
3.5 Statistics

4.Special Thanks
5.Links
Image
Image
Image
1.1. Idea
The simple idea behind Boxes is to offer a Manialink CMS that grants you unlimeted Possibilities. From TMF we know the CMS MyManialink, that got some competition by time, but was spread so widely by good reasons! The problem of the spread of the few succesfull CMSystems is a huge ammount of Manialinks looking quite similar or revealing their CMS on the first look.

While Boxes seperates from the concept of fixed pages and fixed layouts, the user can create his very own layout easily: Like one may know it from operating systems of mobile devices, the widgets can be moved with the mouse all over the window and placed on different pages.

1.2. Extensions
1.2.1. Boxes/Instances
In our system the the different plugins are called "Box". Once such a Box is installed on your Manialink, you can create as many "Instances" as you want (exceptions existing).
For every Box you can select a Style it is displayed in. The way a Box works stays the same, while the style influences the appearance of the Instance.

1.2.2. Designs

On the one hand Boxes have the possibility to display independet styles, on the other hand we established the concept of "Designs". These contain various plugins themed in one Style to create a more or less uniform appearance. Designs only contain the Styles themselves - to use them, the certain Box has to be installed!halten jedoch nur die Styles für bestimmte Boxes; diese müssen vorher bereits installiert sein.
1.2.3. Starterpacks
Starterpacks are .zip-files, that can be easily installed on the Manialink and bring a complete appearance to you. They contain Boxes, Styles, a bunch of pages and already placed instances on the pages. From this point on you can of course re-arrange everything on the Manialink as known. Due to the named facts, the installation of starterpacks overwrites all existing pages and instances!

1.3. Users

Boxes enables multiple users, free editable ranks and settings about the authorizations of each rank. Ranks can be created on your own and edited, the respective authorizations can be selected by clicking in a neat list ;)
Image
Image
Image

1.4. Maniaplanet, Trackmania Forever and your Browser
Because the topic became recent by now, Boxes is primary for Maniaplanet, so it enables ManiaScript for one or another effect.
For our TMF fellows, Boxes recalculates all scales when you open the Manialink in the TMF browser.
Even on top of that Boxes comes up with a webinterface containing some features of the in-game adminpanel. Here you can have a look on your Manialink statistics while on the move, edit users and a lot more. The main reason we wrote the webinterface is because Trackmania often creates Timeout-Errors when you tried to uploaded bigger files like skins to your Manialink - to avoid that you can quite similar to the in-game version upload your files to your manialink from a browser of your choice!

1.5. Different languages
Boxes comes up with a dictonary that at the time of release will bring only englisch and german translations by now. Every entry can be translated into a language of your choice to extend the dictionary. Existing entries can easily be edited. (These abilities are also available in the webinterface)
The used language is the user´s one if he transmits his data, otherways you can choose a standard language.ls ist eine Standardsprache auszuwählen.

Image


2. Installation

2.1. Systemrequirements
To install Boxes you need the following requiremetns:
• About 6.5mb webspace
• At least PHP 5.3 for the Nadeo WebServices
• The PHP Extension curl, in case you want to use the WebServices
• MySQL 5.1.6 or newer

2.2. Instruction
To install Boxes, the downloaded Installpackage (.zip) has to be unzipped and uploaded to your webspace. After that you can open the install.php in MP or your normal Browser.

At first you have to establish a database connection - don´t worry, you can define a prefix for all tables in case you have only one database from your host. As example you could use "manialink_" and all tables would you "manialink_config" etc. In the following steps you have to create your admin user and register the Maniacode for the Gameversion(s) you need. The links to the respective playerpages are given. In case you leave these the fields for the maniacode blank, the URL to your files will be used to made your manialink accessable.

2.3. First steps
Once the installation is finished, the manialink can be opened. In the center you will find one single box: the loginpanel where you can log in with the just created admin user. Instantly you have access to the adminpanel and all the page configs.
The most simple way to start off is to install a starterpack. For that you have to upload the packages on the "Installer"-page of your adminpanel and than to install it with one more click. Like described in 1.2.3 all existing Pages and Instances will be overwritten!
In case you don´t want to use a starterpack, you can download plugins and styles on your own in our official Boxes Shop, upload them on your Manialink and install them just like you would have done with a starterpack.
Whatever method you choose, now you can arrange the boxes, pages, styles by placing, moving or deleting, fill the plugins with content - do what you want to make your Boxes Manialink unique!

In case you want to use ManiaConnect on your Manilink, you should register a ManiaConenct application on your Playerpage and register the needed data in the Adminpanel.

Image
2.4. Installation of extensions
Because Trackmania uses to cancel uploads of bigger files, we suggest to use the webinterface for Boxes/Styles with big or many graphics (zip files bigger than like 2mb).
As well in the in-game adminpanel as well in the webinterface the following steps are mainly the same:
Choose "Installer" in the mainmenu and upload your zip-file in the upload form on the upper right corner. Don´t unzip it before! Alternatively you can upload the zip files directly via ftp. Here you have to pay attention to the folder structure!
Files uploaded via the first method will be listed under the category "Uploaded", the others under "Existing", both on the right side unter the upload form. One click on the "unbox"-icon in front of the names will install the Box. Now the plugins will appear in the left list and will be available on your Manialink.

Image

3. Use
3.1. On-Manialink administration

Even while the most important settings can be found in the adminpanel like you are used to, there are a bunch of abilities drectly on the pages of the Manialink.

3.1.1. Boxbar
If you are logged in, at every Instance you will see the so called "Boxbars". Distinct icons represent options for the instances.
The "Move"-Icon starts and ends the ... well ... moving of the box :D
One Click onto the "Save"-Icon saves the current position.
Another Icon will open a poup with all the Instance-settings, containing a selection of the pages where the Instance is displayed, the ranks that can access the Instance, the coordinates, the styles etc.

3.1.2. Quickbar
The Quickbar is in the bottom right corner of the screen and contains all abilities of settings for the current page, for adding pages and Boxes, a list of all existing pages - even those that are not mentioned in the navigation.
By default you will find a button to hide the Quickbar, one to go to the Startpage of the Manialink and one to reload the current page.
All these options may vary by the used Quickbar version. Same thing goes for the Boxbar.

3.2. Uploads
In the view "uploads" - both in the adminpanel and the webinterface - you will find a list of available categories on the left into which you can upload files. After you selected one, on the right half there will appear an upload form and a list of the upload files with icons to delete every one of them.
As mentioned before we suggest to use the webinterface to upload bigger files, because there you probably encounter less problems.
We advise you against uploading files directly via ftp, this may have some difficulties before beeing able to use the files as consequence!

3.3. Settings
The settings the adminpanel offers are divided into two sides: the first one (upper right) contains all settings concerning the Maniacodes and the Nadeo Webservices (ManiaConnect and something like that for TMF).
The second one contains a list of all settings in the database - these entered by the system, by Boxes or Instances. Aren´t there any heavy problems, we advise you not to change something if you don´t know what you´re doing. It may have terrible consequences! If it is necessary to change plugin settings, the plugins will come up with an interface to edit settings.

3.4. Updates
The page "update" requires the Server-permission "allow_url_fopen". If granted, a changelog and buttons to update will be displayed. The button "Refresh" re-downloads all necessary files. This can be necessary when the system produces heavy errors so the "update" functions can also be found in the webinterface. The rest is self-explanatory.
In case your Manialink can´t connect to the Update-Server, you will be able to update your system from our shop.

Image
3.5. Statistics
Like the name indicates, on this page you will have different views on visitor stats, clicks, logins etc. This won´t just be displayed in boring numbers but in neat diagrams - graphy, pies and maps!
If there is data given (ManiaConnect in MP, addplayerid in TMF) Boxes will list users with name, nickname, last visit and the ammount of visits!
In the adminpanel you have also the possiblity to select the statistics you are interested in by one single click in the calendar.

Image
Image

4. Special Thanks

Seeba: Tips, Plugins, Debugging, Betatest
Buddha: Betatest, Debugging
Maniablog.de-Team: Betatest and the very nice post
TomRiddle: Betatest, Debugging, Plugins

5. Links
Offizieller Manialink
Shop
Download
Blog
Have fun, Blade und P.Roni :thumbsup:
User avatar
gouxim
Nadeo
Nadeo
Posts: 1186
Joined: 14 Jun 2010, 17:20

Re: Boxes Manialink easy and fast

Post by gouxim »

Ambitious project :thumbsup:

One quick bug report: if you have your cookies disabled in Windows Internet Options, you will not be able to login (ManiaPlanet HTTP handling is based on the Wininet API which uses system settings). It's worth mentioning it in the documentation.
Please do not PM for support. Instead, create a thread so that everyone can contribute or benefit from the answer! 8-)
Hylis
Nadeo
Nadeo
Posts: 3933
Joined: 14 Jun 2010, 11:58

Re: Boxes Manialink easy and fast

Post by Hylis »

Great to see it released! :yes:

You are better than us at keeping it soon enough, but we will avenge with great releases as well :mrgreen:
User avatar
TMarc
Posts: 15255
Joined: 05 Apr 2011, 19:10
Location: Europe
Contact:

Re: Boxes Manialink easy and fast

Post by TMarc »

gouxim wrote:Ambitious project :thumbsup:

One quick bug report: if you have your cookies disabled in Windows Internet Options, you will not be able to login (ManiaPlanet HTTP handling is based on the Wininet API which uses system settings). It's worth mentioning it in the documentation.
This is good to know (we should setup some kind of FAQ or update also the wiki) for connection issues where the users have tried everything (e.g. firewall, anti-virus, re-install) and still can't connect.

Perhaps it would be better that ManiaPlanet gives a warning message (like some webpages do):
"Attention, cookies usage is disabled, please enable it for full functionality, or ManiaPlanet will not work!"
htbplayer
Posts: 31
Joined: 14 Jun 2011, 15:05

Re: Boxes Manialink easy and fast

Post by htbplayer »

Thanks to NADEO for the positiv feedback :) .

@TMarc we will have a try to add a feature to Boxes that Users become an Alert then the cookies cannot be saved.

Greets Blade
User avatar
TMarc
Posts: 15255
Joined: 05 Apr 2011, 19:10
Location: Europe
Contact:

Re: Boxes Manialink easy and fast

Post by TMarc »

hehe, if it is possible, this would be good!
I rather thought of a warning by ManiaPlanet directly, since I understood it uses cookies itself, if I'm not wrong here ...
htbplayer
Posts: 31
Joined: 14 Jun 2011, 15:05

Re: Boxes Manialink easy and fast

Post by htbplayer »

Yeah i know but since that is maybe done by NADEO i will have a look and a fix for Boxes.
User avatar
rycardoo
Translator
Translator
Posts: 67
Joined: 05 Apr 2011, 20:37
Location: Portugal - Faro
Contact:

Re: Boxes Manialink easy and fast

Post by rycardoo »

I need a help

Image

The manicode was done to TMUF and does not work as you can see the print.
But if it is for the TM2 manicode works correctly
Any error or bug?

Thx advance and congratulations com Boxes :thumbsup: :3
ImageImage
htbplayer
Posts: 31
Joined: 14 Jun 2011, 15:05

Re: Boxes Manialink easy and fast

Post by htbplayer »

Do you have entered the maniacode in the Adminpanel for TMUF and Maniaplanet. Then you create a new one under adminpanel->config->new maniacode you have to enter 0 or 1 so if you want a manaicode for both you need 2 codes one with the setting 1 and the second one with 0.

And thx for your interest in the project, we are happy about every user caused by the less feedback we get for the time we invested.
User avatar
rycardoo
Translator
Translator
Posts: 67
Joined: 05 Apr 2011, 20:37
Location: Portugal - Faro
Contact:

Re: Boxes Manialink easy and fast

Post by rycardoo »

Thx informations :thumbsup:
suggestion:
Plugins for sticker, stencil and signs.
ImageImage
Post Reply

Return to “ManiaLink”

Who is online

Users browsing this forum: Majestic-12 [Bot] and 1 guest