Welcome to version 5.0 of GuppY, the easy web portal database free.
Version 5.0 of GuppY is not just a plain evolution but a full-fledged revolution for this major new version brings quite a lot of new features in all respects.
Must have additionnal documents to this readme file:
Please read CAREFULLY all instructions material provided before you ask a question on the GuppY forum available on Guppy site (http://www.freeguppy.org/).
Why is this so? Simply because more than 90% of questions asked on GuppY forum have been answered in the help texts. And please, before you post your question on the forum, don't forget to check whether it has not already been dealt with.
All technical questions should be posted exclusively on the forum.
This has the advantage of allowing the whole community of GuppY users to share in your question and make the most of given answers.
As far as thanks and other nice comments are concerned, think of the Guest book on freeGuppY website ... Thank you so much!
Eventually, if you do need to write us for some other reason than technical, please use the email addresse guppy[at]freeguppy.org which is available to all GuppY Team staff.
Enjoy your reading!
Version 5.01 of GuppY has been stuffed with loads of new features and improvements to provide as many services as possible.
GuppY 5.01 can be installed on all hosters systems (or nearly). The only constraint is about your hoster providing service of script language PHP. GuppY will run under PHP 5.1 at the minimum.
No need to be a geek at HTML, or at configuration of MySQL databases, or PHP, because GuppY comes with a full-fledged secured administration interface to manage design and contents of every particular section of your site.
GuppY offer the whole array of usual features in a modern web portal:
- links directory
- downloas section
- photos slideshow
- guest book
- visits counter
- clicks and download counters
- administration area
- optionalmember area, private groups
- url rewriting
- ... and so much more.
GuppY brings an ORIGINAL management with big added value: besides being natively MULTILINGUAL, it allows you to set up a dual language display, so that your site is BILINGUAL- i.e you may choose to display your site in two languages, but Guppy will not do the translation job for you.
Let's give some hints about how to prepare a GuppY website with demonstration content, to do some testing:
Congratulations, You have successfully installed GuppY!
If you do not plan to prepare a new clean database, please delete the install/ directory now.
Otherwise anybody could run it on your website and delete all the contents!
You can also download GuppYPortable on GuppY website.
GuppYPortable is a package consisting in a web server, PHP et GuppY 5.0.0., all packaged with an automated install program for a computer with Windows. You just cannot do easier than that !
The clean setup is meant to erase the demo content and start with a brand new empty GuppY site if you fancy doing so. The starting point for this clean install is anywhere between the first install and anything you did with the content that you may have modified at that time.
It will erase all of the content but keep the current parameters made in the different "Config something" admin areas.
Click "Admin" in the horizontal,menu then "Install" in yellow; then top left hand-side of the management, choose "Clean install" and follow instructions .
Congratulations, your website is now ready to be rub with an empty database; you can add your own contents!
A popup window shows on getting to the Management page: it means GuppY has detected "install" directory 's still there.
Just click the "trash bin" icon to launch deleting operation of "install" directory; just follow the instructions showing.
You now have a running GuppY but you feel like upgrading it. What you must understand in the first place is how the different versions of GuppY have been named.
A Guppy version is identified by five numbers, e.g. 5.01.00. The first two digits indicate the main version of Guppy whereas the third one is the corrective patch number of the main version.
In 5.00.11, main version is 5.0 and this version holds 11 corrections of the main version.
When upgrading, you will have to make a choice: either your Guppy is already running on the last version available, or it is a previous version. In the former case, you have to add a patch to your running GuppY, and in the latter, you'll have to migrate from the old version of GuppY to the latest one.
Upgrade from the same main version (applying the latest patch)Your GuppY is already in the 5.00.xx version (x < 10) and you want to upgrade. To achieve this, you can download patches on Freeguppy. (http://www.freeguppy.org/). And again there are two cases: either your Guppy is in the previous version (for instance 5.00.11 to be upgraded to 5.01.00), or it is in an older version (5.00.xx with x range from 0 to 11 included).
Installation with Installer
Once relevant zip archive of the patch has been downloaded, go to Admin, then general Management and Install.
Click "Browse" to choose zip archive, another click to lozd the file and a last one to install.
And you're done; tour site has been patched in the latest version of GuppY.
Attention: if your hoster restrains upload_max_filesize function to 2M for instance, you might not being able to use function "Install" zip archivesexceeding 2Mo.
You will then have to ask your hoster to increase it up to 10M for instance. With Free, which still restrains at 2M, your request will probably be ignored.
Upgrade from a previous main version (migration)
Important : the migration script is intended for websites running with version 4.6.x of GuppY.
The evolution of version 5 is so substantial that it was not possible to provide a migration from older versions .
If your website runs on an older version of GuppY, you will have to first migrate to 4.6.28 before doing it to 5.01.00.
Migration to version 5.01.00 from a version 4.6.x
That's all. Your site has been migrated to version 5.01.xx of GuppY !!!
Now you can go through full configuration of your site, change skin, and reorganise you site if needed.
Configurating your website:
- First compulsory step:
In "Generalitiess", Click the "password" icon to change it.
Note: You can set tagain the password at "pass" at any time ; just reload original file admin/mdp.php by FTP.
- Second compulsory step:
Click "Configurations, then"General Config" icon to check that the boxes "Site's URL :" and "Meta Identifier URL :" are properly filled in with the EXACT address of the site (ex: http://www.mywebsite.com/ )
Management of your site
When you're done with general configuration and changing password, you can see the seven sections of the dropdown menu on the administration page.
When hovering mouse pointer, each section will open and the icns of this section show.
The whole management of your site is grouped together in these sections.
You will find all needed explanations in the Guppt Help Centre, all pieces of advice and tips to help you customise your site.
Note : In GuppY 5.01, the management page is entirely independant from the other pages.
Managing the contents of your site:
GuppY works thanks to the latest web technologies.
To understand how it works, let's go back to the way a traditional web page is created. In a classical web page, you input some text in the middle of which you insert some HTML (acronym of Hyper Text Markup Language) tags that tell to the web browser (Firefox, Chrome or Internet Explorer for example) how to place and format the different components (text, images, links...) in the page.
You then need to manually link the different pages between them using the HTML linking tag. And, each time you want to change the look & feel of your web site, you have to work back on all pages... This is a heavy and tedious job, and you easily come to spend more time managing the formatting of your pages than their content !
Now there are full web programming languages that allow you to manage the Internet content like any software that runs on your PC. GuppY uses the most used of them being PHP (which stands for Hypertext PreProcessor).
GuppY utilise le langage de programmation le plus répandu, à savoir le PHP (qui signifie Hypertext PreProcessor). The principle of GuppY is the following one : the content (which is stocked in a little "textfile" database) is separated from the formating (which is managed by the PHP scripts that make GuppY)
The principle of GuppY is the following one : the content (which is stocked in a little "textfile" database) is separated from the formating (which is managed by the PHP scripts that make GuppY)
And, we then get what is called a CMS (abbreviation of Content Management System). So that eventually, you only have to input the information in the appropriated areas (articles, news, etc...) using an administration interface (which you reach through the Admin icon at the top right corner of the screen) and GuppY takes care of the management and the formatting of this information according to the clicks of your web site's visitors.
As HTML tagging is allowed, you can use all HTML tags that you want (IMG, A, B, I, U, etc...) in articles, news, links, etc. Check and make sure each time that these tags don't prevent your website to display correctly. By the way, your site will be beautiful too even if you don't use HTML tags.
Note : Visitors to your site can themselves post news, messages in the guestbook or in the forum. The use of HTML tags has been slightly restricted for them, in order to avoid any interference with your site's smooth display, but a tiny editor helps them use most usual tags.
You have 5 available directories to store specific objects (through the use of the Files icon):
Templates possibilities have actually been really improved in this version5.0. Full customisation is possible depending on how well you can deal with cascading style sheets (CSS.
Some more useful information :
The different configuration sections of the layout of your site have been gathered in an admin/Configurations area.
The first icon, Themes Config , allows to specify the general designs of the site (default skin, smileys, avatars et general design theme) and themes specific to the selected skin (icons, counters).
Look Config allows to modify colours and designs of the current skin or any other standard skin!
Don't forget to generate the style sheet of your skin in Style Config. It is a "generic" style sheet that you can completely customize by adding a styleplus.css in Style Config. If there is styleplus.css file will be automatically loaded to view your personal modifications..
Do not make manual corrections in style.css, remember that they will be lost if you refresh the style again by the automatic procedure. You must book your manual corrections styleplus file to keep them even if you generate new style.css. It may be necessary to refresh the page to see the result.
If you want to use the skin no_skin, you have to make firts a copy of it and name it as you like.
Then you can change colours and design as you can do for the skin no-skin.
This change has been made to keep originla state of the skin no-skin so that it can still show in case of crash when adding a new skin.
Some skins will not allow configuring colours and design, when their designers use advanced parameters or don't feel like letting the harmony of their work broken.
Style Config allows though to modify manually the style of the latter (like for all others de toutes les autres) at your own risks because it entails substantial knowledge of CSS language.
If your change won't be saved, it means you need to change permissions (chmod = change mode) in confskin.inc ans style sheets.
The administration page is totally independant and is managed by the skins of the skins directory.
You will get more explanations about style sheets of GuppY in the tutorial about the skins of the v5.0 .
- Internal operation
Let's say it one more time, GuppY does not require the use of a database like MySQL. This provides a great flexibility and many advantages :
Running Guppy means that your browser can manage style sheets CSS and HTML language in version 5 .
GuppY shows smoothly with FireFox, Chrome, Opera, Safari, Internet Exploreur all recent browsers.
It has been tested with these browsers, but your feedback with other borwsers will be welcome.
- Filed upload
Some hosters restrain the upload function HTTP. Function "Files" in admin will then be restrained, say at 2Mo. In that case, your favourite FTP (File Transfer Protocol) software will do the job.
- Content sharing between sites in RSS format
In that case, the news sharing module between sites in RSS format will not work.
- How to access the mobile version of GuppY ?
If your site is accessed this way: http://www.yoursite.com/here/ (for example), then the mobile version (which is a lightened version of GuppY aimed for smartphone users and blind people) is easily and automatically accessed this way: http://www.yoursite.com/here/mobile/. Just put a link in your web site for telling your mobile visitors how to access it.
GuppY is protected and distributed freely under the terms of the free CeCILL license (see pages/copyright-en.txt file). It means that you can use this script for free, modify it for your own use. If you distribute a modified version of it, this modified version has to comply to the CeCILL license as well. Please follow our recommendations about copyright concerning version 5.0 and following.
* About GuppY
* GuppY PHP Script - version 5.0
* CeCILL Copyright (C) 2004-2014 by Laurent Duveau
* Initiated by Laurent Duveau and Nicolas Alves
* Web site = http://www.freeguppy.org/
* e-mail = guppy[at]freeguppy.org
* V5 developed by Lud Bienaimé
* with the participation of Jean-Michel Misrachi and the GuppY Team
* Version History :
* v5.0.0 (February 15, 2014) : initial release.
- Logos Powered by GuppY andFree CeCILL License that come with GuppY packages and patches are compulsory at the bottom of each page of Guppy sites.
They musn't be hidden in any way (CSS, images, videos, code modification, logosin matching or others).
The only permission is granted to modify the shapes and colours of these logos to match at best with the graphic charter of the concerned site, taking care not to make them little or not visible.
- The logo Powered by GuppY shall take through the associated link to the url http://www.freeguppy.org
- Le logo CeCILL Free License shall take through the associated link to the url http://www.cecill.info/index.fr.html
- The plugins, forks and skins must include files headings under CeCILL license and complying with its rules.
An exception is made for the author who does not submit his work to any license. In that case, the author's right and intellectual property will applyle.
- Translations oh language files or others shall be under original CECCILL License.
- Translations of the FAQ and various ddocumentations must also with no exceptioe under original CECCILL License.
- Toute borrowing of article, news, post, FAQ, documentations post on the forum of www.freeguppy.org or the satellite sites under controll of the GuppYTeam and the Asso freeGuppY shall include a quotation of its source with a direct link to the original.
WE WILL NOT IN ANY CASE BE LIABLE TO RESPONSABILITY IN INCONVENIENCE THAT COULD BE A CONSEQUENCE OF THE USE OF THIS SCRIPT.
We appreciate your support
All members of the GuppY Team are volunteers; they are involved in development, follwing-up, updates of the sites on their spare time and nights according to their possibilities.
We thank you very much to keep this in mind when posting your comments..
If you like GuppY and you wish to help us promote and develop it, you are very welcome.
If you like GuppY, you can indeed do a lot and distribute skins, plugins, forks and contribute to promoting GuppY by referencing it on specialised sites and directories.
You've been participating in the project for a while, and wish to get involved further, then please contact us!
You application will be put to the vote of the Team, and the majority will decide your coming in or not.
Here are a few ideas to improve it and for which your help will be more than welcome (there are improvements for all kinds of good willing people):
If you would like to gert involved but not in the depths of the software?
The freeGuppY association keeps looking for members and volunteers to take on all the tasks linked with GuppY, or plainly take a subscription or make a donation to the association.
Any amount will be very much appreciated; it's the gesture that counts
To make a donation or pay your subscription, just type in the desired amount next to the Paypal button, then click this PayPal button (secured transaction) :
To contact the asso freeGuppY, just go to this address : http://asso.freeguppy.org/
Several scripts are being used in version 5.0 of GuppY, you will find the list below.
We do address all our thanks to their authors for their work and for choosing licencesallowing their scripts to be freely used.
Copyright (c) 2003-2014, CKSource - Frederico Knabben. All rights reserved.
For licensing, see LICENSE.html or http://ckeditor.com/license
MinieditorTextarea written by Djchouix - Licence CeCILL
Author : Jérôme CROUX (Djchouix)
Web site : http://lebrikabrak.info/
Author: Stefan Petre www.eyecon.ro
Dual licensed under the MIT and GPL licenses
Licence : GNU Lesser General Public License
Author : Jérôme CROUX (Djchouix)
Web site : http://lebrikabrak.info/
(c) 2006-2007 Sylvain BRISON
adaptation Lud Bienaimé pour GuppY 5.0
Licence CeCILL modifiée => Voir fichier Licence_CeCILL_V2-fr.txt
Contact: via sourceforge.net support pages (also www.worxware.com)
Authors: Andy Prevost (codeworxtech) codeworxtech[at]users.sourceforge.net
: Marcus Bointon (coolbru) coolbru[at]users.sourceforge.net
License: Distributed under the Lesser General Public License (LGPL)
by Lokesh Dhakar - http://www.lokeshdhakar.com
Licensed under the Creative Commons Attribution 2.5 License - http://creativecommons.org/licenses/by/2.5/
- free for use in both personal and commercial projects
- attribution requires leaving author name, author link, and the license info intact
Author: Markus F. Hay
Website: http://lytebox.com (http://dolem.com/lytebox)
Date: January 26, 2012
License: Creative Commons Attribution 3.0 License (http://creativecommons.org/licenses/by/3.0/)
- The informal team :
aldweb - (That's me!, from France), GuppY's creator and main developper.- e-mail : email@example.com- Web site : http://www.aldweb.com/
JeandePeyrat - (The "Servers'servant!), GuppY Team administrator, president of the association freeGuppY, forum moderator, freeGuppY servers maintenance has no secrets for Jean.
Papinou - (The "wizard of CSS"), GuppY Team administrator, Treasurer of the association freeGuppY, forum moderator, interested in everything concerning CSS style sheets and not bad at all at English!
DJchouix - (The scientist), a great developper has been working noiselessy for so many years. He is the author of the new GuppY editors.
Corrector - (The"king of translation"), the English language is his second mother tongue, but the corrections of the French language are also his line. He is especially hard on Frenglish.
La Vache Qui Rêve - The dreaming cow! as she has named herself - But she is so much more feminine and subtle than that! - (GuppYed, tutos) - GuppYed administrator and tutorials specialist in addition to keeping our stable tidy.
Fred68 - (GuppYed, tutos) - GuppYed administrator and tutorials specialist, an excellent tutorial for CKEditor is one of his major works.
Sabine - our design fairy, will in a trice dress up a lovely layout for GuppY, made in Quebec. Check out tht tutorial skins 5.0.0!
Laroche - a GuppY geek who knows all subtleties and cogs on his fingertips, and not the least of squeak-killers!
Pascal31 - (GuppYLand, GuppYLand administrator, designer of the homepage presentation.
jerlal - (GuppYLand) GuppYLand administrator, alpha versions beta-tester , or fierce squeak-buster ...
Distinctive thanks to our friends:
- Saxbar who, since August 2011, has carried out the developement of version 5.0 with persistence and panache, keeping on the lookout innovating solutions !
- JeanMi for his invaluable help, his advice, the accurate solutions he comes up with due to his perfect knowledge of GuppY!
- Sabine for her skins and her excellent tutorial, Lavachequireve, JeandePeyrat et Papinou for the realisation of the help system and Corrector for proof-reading and translation!
Thank you to all members of the GuppY Team, all the beta-testers, among which BTSCPIfr, dipisoft, equitathome, Ludo, Phil-ogm, Roule, rvknobzh
We very plainly say than you, for this gorgeous version 5.0.x made available to Guppy users.
Many thanks to all those who submit improvement ideas,Many thanks to all those who post comment or send warm encouragements.