GuppY Manual v46
Transcript of GuppY Manual v46
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 1/65
GuppY
The Manual
Version 4.6 Updated on 28. July 2007
English version : Kévin L. (Fr) and Béla U. (Hu)
© Bruno Dekeyser – 2006/2007
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 2/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P2/65
French version also downloadable at http://www.freeguppy.org
Document realised and exported in PDF format with OpenOffice.org (v2.1fr)
This document is subjected to GNU FDL licence. That means that it is free of rights .
You are allowed to distribute and modify copies of this manual as long as this note clearly appears
and as long as GNU FDL licence is respected.
For more information on this licence, see appendices of this manual .
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 3/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P3/65
Contents
GUPPY................................................................................................................................................... 1
CONTENTS............................................................................................................................................ 3
USE OF THE MANUAL.......................................................................................................................... 5
INTRODUCTION ................................................................................................................................... 6
THE GUPPY«LOOK» ............................................................................................................................ 7
HOW TO FIND AND INSTALL GUPPY................................................................................................. 8
WORKING WITH GUPPY «IN LOCAL»................................................................................................. 9
SETTING OF PARAMETERS.............................................................................................................. 13
MANAGING THE CONTENT OF GUPPY............................................................................................ 31
ABOUT PLUGINS................................................................................................................................ 40
UPLOADING GUPPY ON LINE........................................................................................................... 41
WORKING ONLINE............................................................................................................................. 44
PORTAL MANAGEMENT.................................................................................................................... 48
ACKNOWLEDGEMENTS.................................................................................................................... 49
THE «MOBILE» FOLDER.................................................................................................................... 50
APPENDICES....................................................................................................................................... 51
TABLE OF CONTENTS....................................................................................................................... 63
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 4/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P4/65
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 5/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P5/65
0
Use of the Manual
This document aims at being a manual for the initiation of GuppY.
It is not necessary to carry out a linear reading of this manual. Chapters and contents (located at the
end of the document) allow you to navigate easily. However, if you are beginner to GuppY, it is
highly advised to follow the manual "step by step" in order to measure well all the possibilities, all the
power of GuppY.
All the terms marked with an asterisk (*) are included in the lexicon.
The listing of modifications made to the present manual for its passage from the v4.5 to the v4.6 aregiven in appendix.
Read attentively this documentation as well as the "Read-me" file provided with the software before
posting any request on the GuppY Forum (http://www.freeguppy.org/). Indeed, more than 90% of the questions posted there have their responses in these two texts.
Although being the principal writer of this manual, nothing could have been done without the
assistance of the formidable GuppY Team .
I also wish to point out that the drafting, page-setting and exporting in "pdf" format were made thanks
to OpenOffice.org (version 2.1 -fr under Linux Ubuntu 7.04 «Feisty Fawn») which is a free
productivity suite, complete and tremendous for its simplicity and its effectiveness.
GuppY is used in the whole world ! Here is the geographic coverage on February 2005 :
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 6/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P6/65
1
Introduction
1.1 An extract of the "Read me" file
GuppY is a Web portal* which does not require a database to run .
This thus makes it possible to install it on all Internet hosts (or almost), the only need is that your host provides you the PHP script language service.
There is no need to know the HTML language, nor SQL database config, nor PHP; GuppY offers an
interface of complete and protected administration to manage the appearance and the contents of thevarious elements of your site.
GuppY proposes the whole of the traditional functionality of a Web portal :• news• articles• links directory• download section• diaporama of photographs• guestbook
• forum• FAQ• poll• visits counter • click counter • newsletter
• administration area• optional member zone• different administration• etc.
But, GuppY brings an original management: in more of being multi-language, GuppY offers an optional
presentation of the bilingual contents, with a choice of 2 languages to display.
1.2 What's news in this 4.6 version ?
GuppY 4.x versions reach a new step of functional maturity.
Beside, v4.6 of GuppY is not offering only innovations, but some optimizations and functionality too :
• There is a high quality forum, which has a
configuration page of its own. It has a lot of functionality : previewing, possibility to correct a«post*» just after validation, going up of a «thread»customizable, locking...
• The birth of a «Blog*» section including all that isrecquired to be a complete one.
• Replacement of the mini-editor of the admin section
and integration of «FCKeditor» which is moreergonomic and which allows to include «Flash» in anarticle.
• Improvements of «Photos» and «Photorama»
• Many other improvements!
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 7/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P7/65
2
The GuppY«look»
The header includes the various essential icons with the correct operation of GuppY (the «admin»icon, located at the extreme right-hand side of the header presented below – which is only one
example among many possibilities - is not showed here):
A click on one of these icons brings you to the corresponding page (note that the names of the icons
should not obligatorily appear in it, this can be modified).
The boxes can be laid out freely in various places of the page (note that you can choose to activate,and thus to display or not these boxes )
Lastly, GuppY is entirely " skinnable " : equip it as good as it seems to you and do not hesitate to go
to GuppYLand (http://www.guppyland.org), a «satellite» site of the official one. You will find there
all that you need (and even more) to change the appearance of your GuppY.
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 8/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P8/65
3
How to find and install GuppY
Only one address, the official site : http://www.freeguppy.org
The GuppY file: guppy.zip of ~2400 Kb
The file of the languages (essential if you wish to manage other languages than French and
English): Guppylang.zip of ~700Kb ).
When GuppY is downloaded, you have to unzip it in a folder of your hard drive (for the «lang» file,have a look at its «Read-me» file)
Pay attention ! If you download EasyGuppY (see next page), GuppY is already present in this
package (check its version number anyway: sometimes a new guppy file is produced, as for example
after a correction, without changing the EasyGuppY package).
Two options are then bringing to you : working with GuppY in local on your PC or on-line on
Internet.
Personally, I highly advise to test initially GuppY in local. It will always save time, when the site isat the point, to put the whole on line.
Consult also the "step by step" cards of Laorens on GuppY-Education. (http://guppyed.org/).
Users of Macintosh and Linux (I cannot help using it !) are not forgotten: a special section forthem is available at the end of this manual.
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 9/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P9/65
4
Working with GuppY «in local»
For that, it is essential that your computer could manage the PHP language.
Fortunately, the team of GuppY is, once more, here to help you with EasyGuppY.
This kit of development (including three software : BRS WebWeaver, PHP and GuppY) makes it
possible "to transform" your computer into a local Web server. It runs under Win 9x, Me, NT, 2K andXp.
(See you at the end of this manual for a local use under Linux and Mac)
But do not panic, there is no need for knowing oneself the configuration of PHP… GuppY and
EasyGuppY take care of all !
4.1 About PHP
PHP is an interpreted language (a script* language) execute on the host side (like CGI, ASP scripts…)and not on the client side (unlike Javascript…).
The syntax of the language comes from the Perl, Java and C languages. It has the advantage of beingable to be integrated inside HTML pages and can be easily interfaced with the large majority of the
market of DBMS (Data Base Management System).
4.2 EasyGuppY Installation
Just double-click on the downloaded exe, then choose the destination folder (advice: accept the one
proposed by default: C:\Program Files\EasyGuppY \ ) and follow the procedure.
However, the GuppY software included in the package might not be the last updated one. I advise you
to download the last GuppY update too on the official website, then unzip and install it in the rightfolder (i.e. C:\Program Files\EasyGuppY\www\).
4.3 Launching EasyGuppY
One cannot to be strictly accurate of the launching of EasyGuppY, it acts oneself in fact as a server
Go to Start | Programs | EasyGuppY | EasyGuppY.
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 10/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P10/65
Your browser opens then a banner page and a click on "Launch GuppY " opens the very new
GuppY.
However, if you placed other GuppY in the adequate directory, or folder (i.e. C:\Program
Files\EasyGuppY\www \), they will also appear in the window and a click opens the corresponding
GuppY (very useful to work with several Web portals).
Note : once Easy GuppY launched, an icon is placed in the task bar near the clock. A right click gives you access to various menus ("Exit" makes it possible to close EasyGuppY).
4.4 Using the www folder
So that your PHP pages are interpreted*, it is imperative to place your files in the «www» folder.
It is advised to create one folder by project in the "www " folder in order to have a clear vision of thedevelopments.
In our case, we will use GuppY that we will have installed in the “www” folder of EasyGuppY. Do
not hesitate to use it as a bench test and preserve it, you will use it thereafter as a zone of test.
There once at the point, create a new folder in "www " and place new GuppY which will be the baseof your official portal.
4.5 Keep in mind
NOT TO DO : To go in the "www " folder then in the folder corresponding to your project and
double click on your page of example. You will undoubtedly obtain an error page.TO DO: to launch Easy GuppY and, in the displayed page, click on "Launch GuppY " (or the
desired file).
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 11/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P11/65
4.6 Configuring GuppY
To configure GuppY, it is important to follow the connection process :
1) I register as a member («preferences» box).
2) I click on «admin».
3) I write the word «pass» as a password.
4) I immediately change this default password («pass») in the «Password Admin» section.
5) I click on «Back to Admin» to reconnect with my new password and to proceed theconfiguration.
The interface of administration presents four quite distinct areas and two disconnection buttons.
The «Skin Configuration» area:
The « General Management » area:
The «Data management» area:
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 12/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P12/65
The «Plugins management» area :
A good working method consists of using the tabs of the browser (I advise you to use «Firefox»)
in order to have two fields of work : one for working in the «admin», the other to see the changes (so
refresh this second tab to see them).
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 13/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P13/65
5
Setting of parameters
This is done within two main areas :
Area 1 : « Skin Configuration»
Area 2 : «General management»
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 14/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P14/65
5.1 Theme Config
This page allows you to manage the main themes of your site and those of the selected skin too
(default skin, icons, counter, smileys, avatars and cursors).
5.1.1 Icons, counters, smileys :
Managing the icons theme
You can use your own icons for your portal. The only need is the site where to save them and their
name :
✔ create a sub-folder in the «\inc\img\» folder (as example in the GuppY _ icozerg folder created for
the occasion : «C:\Program Files\EasyGuppY\www\GuppY\inc\img\GuppY_icozerg\» ;
✔ there place 12 images named admin.gif, blog.gif, download.gif, faq.gif, forum.gif, guestbook.gif,
home.gif, links.gif, news.gif, photo.gif, react.gif and stats.gif (! the name matters, the extension
must be «.gif» and the size is imposed : 32x32) ;
✔ it only remains you to choose the adequate name in " icons theme" and GuppY will be given the
responsibility to place icons at the good places.
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 15/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P15/65
Managing the counter and smiley themes.
The principle is the same one as for the icons.
5.2 Look Config
This page only manage the aspect of the skin : background, colors...When validating, it is sent to the«Generate CSS» (see further).
Note : The creator of a skin can «freeze» its aspect by forbidding the «Look Config» use andthe «CSS» generation by adding «mod_css = ''off''» in the «skin.inc» file.
5.2.1 GuppY includes a «colour-code» tool.
Activation is done while clicking on the form button adopting the color chosen in the palette .
You then obtain a palette (pop-up window integrated into the principal window) of 216 colors as well
as a whole range of gray.
Click on the color or the desired range and its hexadecimal value is automatically displayed in
GuppY.
5.2.3 The GuppY «effects»:
You can parameterize various effects which will give a pleasant pace to your site: the transitionbetween pages (avoids a brutal change, not very pleasant), the displaying of the pages loading time,
the opening or not of a pop-up window indicating that a page is loading (that avoids clicking several
times unnecessarily), an effect of links animation…
5.2.4 About the size of textsUsually, users of Internet Explorer only have to enter a number to size the text, while others needs to
add the number with "px " (that indicates the unit, i.e. the pixel*).
The method does not matter, the major disadvantage residing in the fact that the size of the posted text
is imposed to visitors, since it is fixed.
Consequently, only those using the standards sizes provided by the browser will fully benefit from
your pages. The others, those which do not use the usual sizes(partially-sighted persons, for example,
who use larger font size) will be penalized because their posting will be brought back to too smallsizes for them (yes, since you impose the size!).
It is wise to choose a font of a relative size, i.e. likely to be increased by your visitors and adjustable
with their own way. Then prefer the sizes specified in points (Pt), expressed as a percentage (%) or inem.
In addition, a size of 14 points seems to be the acceptable size minimum by the partially-sightedpersons. Be all the more attentive there as they are numerous to surf on the web.
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 16/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P16/65
5.3 Boxes config
This page allows you to manage the arrangement of the upper part of the site (icons, banners, logo,
etc.)...
... and to select the position of the lateral and central boxes of the skin in use.
This is an innovation of this version : boxes are skin co-dependant. So, according to the appearance
you choose, the position of boxes may change. Whereof making a very personnalized GuppY !
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 17/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P17/65
5.4 Generate CSS
This page aims to manage the stylesheet (in order to modify the existing sheet or to generate a new
one).
«Generate» creates the style sheet of the skin from a standard list and from «Look Config» datas
(Here, we have modified the «no-skin» skin previously selected) :
«Modify style» allows you to rewrite this sheet or a personnalized existing one.
! Use this only if you perfectly master the CSS language !
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 18/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P18/65
5.5 General management
This page makes it possible to define the general parameters of the site.
All the fields * are significant and require much attention and preparation from you.
The URL of your site is automatically indicated (in the event of manual encoding, this one must
obligatorily ends with a slash: http://randorous.free.fr/).
This field is essential and must be validated to be taken into account .
5.5.1 Irreversible parameters
The choice of the languages, the format of the date and the format of the hour are to be well chosen
once and for all during the initial parameters setting.
If you select only one language, you will not be able to add a second language thereafter.
Here, at the time of the drafting of the manual, the list of the languages available if you install the
"Pack languages" of GuppY (the French and English languages are integrated by default):
German, English, Arabic, Chinese , Danish, Spanish , Finnish , French, Greek, Dutch , Indonesian,
Italian, Lithuanian, Norwegian, Polish , Portuguese, Rumanian, Russian, Serb, Slovak, Swedish,
Swiss German, Czech, Turkish, Ukrainian.
a) Warning, if you choose a second language, it will belong to you to translate the contents of your
pages, the titles of the sections… GuppY will display then, in banner page, the choice of the language
of the site.
b) The date and the hour are available in several formats:
5.5.2 Other parameters
The slogan
From here you make the choice of your slogan (important, since it will scroll in the status bar of the browser ; however, if you do not wish a scrolling slogan, leave the box empty)
The Compression of the pages
To accelerate the pages loading, tick the compression option. With it you measure the loading rates, to
decide better adjustment (box ticked or not).
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 19/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P19/65
The copyright
GuppY is under CeCILL free licence. The copyright appears on all pages. You can only modify the
size and the position of the logo, or decide to not show the logo (but the text will stay in place).
Be respectful with the work provided by the GuppY TEAM and do nottry to mask this copyright !
Indeed, by hiding it, not only you will not respect the licence (see next paragraph) of the software,
that is reprehensible, but especially you will show disrespect to our team which, I point out it,
consists of voluntary workers offering their spare time to offer a product of quality to you.
Here is an extract from the judicial CeCILL service about the copyright mention :
By downloading the software, the licensee commits to respect the terms of the CeCILL licence and especiallythose related to its article 6.4 imposing the licensee to reproduct to the identical the mentions of intellectual property concerning software's copies. You have the right to impose to this licensee to inscribe on all softwarereproduction the mention «Site runnning under GuppY v...- © 2004-2006 - Licence Libre CeCILL».
If the licensee does not comply with these terms, you can send him a letter asking to suscribe the legal mentionon each software copy. In the absence of rectification within 30 days, you can resiliate his licence. So, this user will not be allowed to use, modify or distribute the software (Art. 10 licence CeCILL).
More infos here : http://www.cecill.info/licences.en.html
Meta Tags management
The META tags, coming from the HTML language, allowing a referencing of your site on the various
search engines. More than half of the Net surfers are using these engines, it is significant for it to
appear in a good position.
Note: META tags should not be cut, therefore no line return !
TAG DescriptionLanguage This tag declares the main language used by your Web site.
It is very useful as many anglophone search engines include the language in their search criteria.
Title The search engines strongly pay attention to the title of the documents.
The error not to be made: do not give to your page the title "home " or "index ".
Description Phrases taken care by the search engine like descript ion of your si te.
The words, which constitute this sentence are also regarded as keywords by the majority of the engines.
Numbers maximum characters: 200. Avoid phrases that aren't significant.
Keywords Indicates to search engines the keywords related with your site.
Place your most significant keywords at the whole beginning.
Your keywords must be separated by commas (Example : html, xml, java, ...).
Maximum numbers of characters: 500.
Do not hesitate to use expressions (Example : html guide).
You can alternate keywords of French and English language.
You can register the significant keywords of your site in capital letters and in small letters.
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 20/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P20/65
TAG Description
Do not repeat several times of continuation the same keyword.
Identif ier URL This tag makes it possible to indicate the URL of the site.
Ex. http://randorous.free.fr/
It takes again the principal address defined in the file of configuration of GuppY.
Avoid the typing errors…
Robots Allows specifying the folders to be referred or exclude for the robots (spiders) from the search engines where
you referred yourselves.
• All ? indicate to the robots to index your pages and to follow the links of one page to the other.
• Index ? The page will be indexed by the robot.
• None ? Indicate to the robots not to index your pages and not to follow the links.
• No Index ? The page will not be indexed by the robot.
• Follow ? The links contained in the page will be indexed.
• No Follow ? The links contained in the page will not be indexed.
The most used solution ? Index, Follow
Revisit After Allows to specify with the spider (robot of the engine) to re-index your site according to the interval in days given.
Never write "1 day…"? 14 days is the minimum.
Author Allows identifying the author of the site.
Your name in capital letters, your first name in small letters.
You can, if you wish it, put several authors (separated by a comma).
Only the « Nomade » engine indicates the name of the author.
Owner This tag indicates the name of the site owner.
Reply-To This tag indicates the principal e-mail address of the site author.
It allows the Net surfers who have recorded your page to contact you.
Avoid the typing errors… !! !
This tag is an open door to the Spam, these advertisements and other viruses which encumber your mailbox.
Inform this tag only if you are fully aware of what is the Spam: your e-mail will be reproduced on the search
engines but your mailbox will be saturated with poisonous mails.
Note: keep e-mail in the box "Webmaster Info «, there you do not risk a lot.
Rating This tag makes it possible to define the public concerned.
You can choose between «General», «Mature» or «Restricted».
Distribution This tag indicates if the document is widely diffused (Global) or restricted (Local).
Copyright Allows specifying the copyright of the site.
=> implicit concept with the use of any document present on the web but alas not enough presents in the spirit
of many Net surfers.
! Respect the copyright, respect the authors!
You can put several names (separated by a comma).
Classification Allows specifying the category of your site, useful for certain engines which generate a classification bycategories.
=> not currently present in GuppY.
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 21/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P21/65
5.6 Services Config
This page makes it possible to select the services you wish to activate (by simply ticking them) inthe site, but also to supervise the return-mails.
5.6.1 Management
It is here that you will carry out administrative choices such:
✔ Quick access to articles Admin ;
✔ the choice between the standard editor or FCKeditor :
(See details for editors further).
✔ the displaying or not of the "admin " button (warning, if it is not displayed, you will have to add " /
admin" to the URL of your site to reach the zone of administration:http://www.mysite.com/admin/) ;
✔ the activation of collaborators. This will be detailed further.
5.6.2 Menus aspect
GuppY offers two presentations ("list" or "dynamic") for your menus in the articles boxes :
The menu with list
A menu with list is a traditional menu :
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 22/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P22/65
The dynamic menu
A dynamic menu makes it possible to shorten the height of the box " Articles" because all the sub-
menus appear only when one clicks on the arrow of " listbox". There are currently three kinds of
dynamic menus: the traditional one, the n°1 and the n°2.
The traditional dynamic menu:
A click on the arrow located on the right unrolls the contents. It any more but does not remain to click
on the article wished to see it to post itself.
The dynamic menu n°1:
A click on "+" displays the articles, a second click ("+" became one "-") closes again the list ("-"
becomes again one "+").
The dynamic menu n°2:
It has the same principle that n°1, but "+" and "-" are replaced by symbols.
5.6.3 Other services
Other services are available, among them, there is:
The number of elements service that determine the number of item that will be displayed on each page
for services : articles reactions, news, blog comments...
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 23/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P23/65
Supervision e-mails: you can receive supervision mails for different events : to be warn for a new
post on the forum or the guestbook, a newsletter unsubscription , the posting of a news....
However, this service only runs with hosts that allow it (it is often deactivated on free hosts). Then
select carefully the email function as some host have a specific version of this function : be informed
by them if you don't know which one to use.
Otherwise, test the different functions and check for email. If you do not receive a mail, thenyour host doesn't allow this function .
Anti-spam system : Guppy includes an anti-spam system that prevents from receiving this non
requested mail (the spam is the action to send electronic mails (e-mail) with an advertising or promotional aim, which they are commercial or not, and in general in great number, with people who
did not request it by using mails that appears in forum, guestbook...).
✔ The maximum number of memorized code shows the quantity of malicious codes that the
antispam data file has to memorize. (minimum 50);
✔ The Period of validity of a code in minutes corresponds to the time while a code is remaining
in this same file before being replaced by another one (10 minutes minimum).
So, if an user sends a script in a post to the forum, this command will be memorized for atleast 10 minutes (see the upper illustration ). Then if it's a script that is sending a flurry
publication, every post including this script won't be allowed to be posted.
RSS cache management : You can manage the duration of the RSS cache. This cache makes
possible to display "news" published on a friendly site.
The duration of the cache is the time after which a "checking" will be carried out on the friend's site to
see whether news were published or not. The choices of time are 15', 30', 1h, 3h, 6h, 12h or 1d.
5.7 Areas Config
This page makes possible to give the title of your choice to the various sections of the site.
It is here that you will be able to modify the heading of various elements (for example, «Download» by «Get it», «Forum» by «What about a discuss ?»...), but also of certain boxes («Articles» by
«Headings»...).
G Y h l 4 6 © k 28/0 /0 24/6
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 24/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P24/65
If a box remains empty, the name of the corresponding section will not be posted. Useful not to postthe texts below each icon (reception, news, stats…).
5.8 Homepage ConfigIt is here that one defines the elements appearing on the banner page like their position on the page.
Note: to obtain the ID (Identification) of a Guest Book message, go in admin | Guest Book.
5.9 Forum Config
The Forum config section allows you to :
• Write and display the forum charter
• To display it on fullscreen or two columns mode
• To choose between one or more discussion categories (with the number of each one, no more than12)
• To display an icon «new» for a new thread (and to select, in days, the duration of displaying it)
• To maintain a thread on top (in hours), that's to say as the first thread seen by users.
• To maintain a thread on top (in days), that's to say as the first thread seen by admins.
GuppY the Man al 4 6 © Br no Deke ser 28/07/07 P25/65
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 25/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P25/65
Of course, it is necessary to be member and author of a post in order to manage this kind of modification (those seen upper, but the possibility to preview a post, to modify it or to lock it too)
For sure, only the admin has higher authorizations than the ones of the user. Then, he can manage allthe posts of a forum, including the possibility to lock it (that's to say that no one can add an answer).
It is also possible to select the scale of number of messages that makes the difference betweenconstant and occasional users.
! Do not forget to save your changes with the «Save» button that is just below these twowindows. The same button that is placed bottommost only corresponds to the «discussioncategories» section !
The second form available in the «Forum config» let you name each categories :
! Do not forget to save your changes with the «Save» button that is just below this window.
GuppY the Manual v 4 6 - © Bruno Dekeyser - 28/07/07 P26/65
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 26/65
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P26/65
5.10 Forum archiving
The archiving of the forum makes it possible to archive the discussions of the forum from a date of
your choice. These discussions can always be read by your visitors, but it is not possible to answer it
any more. The utility of this archiving increases the speed of the forum, use this when the forumsaturates.
Ensure you to have carried out an integrity check of the database before launching a forum archiving.
In addition, note that a new integrity check will be launched at the end of the archiving process.
Moreover, better to deactivate the forum module before launching this archiving operation. And, of course, it is appropriate to input a date of archiving.
5.11 Members zone managing
The management of the members, great innovation of this version, makes it possible to restrict theaccess of certain zones of the site to the only members who will have been recorded in the
" Preferences " box (the inscription requires that the browser accepts the cookies!)
You will activate this option while notching « Management with members area» (in «Config member area»). Select then the sections whose access will be reserved to members only: a notched boxmeans that the access is forbidden to the no-member visitors .
You also have the possibility to remove a member and to write a message to all your members.
5.12 Permits
It is here that you create or modify the rights of access of your collaborators (! avoid creating a formfor your pseudo of admin!), or that you remove a collaborator. Only a registered person can get this
permission.
To register, just complete the field of the Preference box and click on « send ». Then, complete the
new fields (memorize your secret code !) :
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P27/65
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 27/65
pp , y
Start by choosing a collaborator among your recorded members. You end then to a window allowing
to allot or not certain rights of access: a ticked box = right of access. (Avoid to use your admin login
to complete such forms, being an admin already give you all rights !)
When you are connected as a member, a click on the admin button leads you to the following window
:
When logged, the collaborator will only have access to what he has been allowed to :
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P28/65
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 28/65
5.13 Password:
For obvious reasons of safety, change the password of administration provided by default (for recall: it is " pass ").
Do not forget to disconnect you at the end of the session from work. Thus, the following user of thecomputer will not be able to touch there. Note well that the password is automatically deactivated
during the closing of the browser.
If you forgot your password, you still have the possibility to upload again the «mdp.php» file via ftp: the default password is then set again («pass»), you just have to change it !
5.14 Integrity checkGuppY is equipped with an integrity control tool of the DB (for Data Base).
Indeed, if two visitors of the site write simultaneously messages on the forum and the guestbook for
example, or if they post news at the same time, or finally if they send recommendations to the same
moment, the GuppY DB can be to some extent disarranged , disturbed by these multiple simultaneous
requests. This is why these messages are posted in double under the same number, for example.
That indicates a misalignment of the data of the file "dated/ " and it is advisable to launch a control of
integrity of the DB to realign it.The control of integrity thus makes it possible to check the existence of errors and to correctthem.
In practice, if the database is large (if the site contents are significant), it is necessary to proceed by
piece of documents or BATCH* in order to overcome the restricted execution times which sometimesservers impose.
In the example below, control will be carried out for documents 1 to 5 (on a total of 6 documents).
The result is then displayed on the screen.
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P29/65
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 29/65
It stops when it have controlled the totality of the documents.
If you click on " Launching the database integrity check in BATCH ", no need to enter the numbers of
documents, control will be carried out for all.
It is in any event salutary to launch a control of integrity from time to time, even if none of the
misalignment symptoms appears in an obvious way. In fact, as soon as a problem disturbs your portal,make turn a control of integrity, whose repairing virtues are well-known.
5.15 Maintenance
This page makes it possible to remove definitively or to restore in inactive status (it will thus benecessary that you think of reactivating the restored elements) the contents (articles, news…) which
you previously chose not to use anymore in the other sections.
You can visualize the contents in question, to restore it if you changed your mind or to definitely
destroy it.
Caution: the destruction on this level is irreversible!
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P30/65
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 30/65
5.16 Working
Sometimes you may have to deeply work on your website. It is then ??? worth to set your website
«offline» for a certain time.
The Work section was made for it : being a member and having the rights given by your admin, youare allowed simply to place the site under working (do not forget to deactivate it as soon as you have
finished your work)
Your portal will be then unavailable to visitors :
5.17 About
This page informs you about the software and its authors.
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P31/65
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 31/65
6
Managing the content of GuppY
6.1 The running principle of GuppY
GuppY runs using the PHP program language (Hypertext PreProcessor).
Its running principle is relatively simple: the contents (stored in a small "text "database ) areseparated from working (managed by PHP scripts). It is what one calls CMS (ContentManagement System).
Thus, it does not have to trouble you any more about management and presentation: you enter
information and GuppY takes care of the remainder (unlike a traditional page HTML where the least
modification of aspect, for example, must be reflected on each page of the site).
6.2 You have four folders to pose the specific objects
! Respect the text format (capital and tiny) in the names and extensions!
6.2.1 file (C:\Program Files\EasyGuppy\www\…\file\)
This one contains the files for downloading.
You will refer then to a file via the following HTML tag :
<a href="file/filename.ext" title="Text which appears in info-bubble">text</a>
where « filename» is the name of your file and «.ext » is the extension of the file.
E.g. <a href="file/model.zip" title="Download the model of the project ">model</a> for a file
proposed to download.
6.2.2 img (C:\Program Files\EasyGuppY\www\…\img\)To place the basic images, the logo of your site and the whole of the images with which you wish to
decorate the site. Advice: place there the images BEFORE integrating them in the site!
You refer then with an image via the following HTML tag:
<img src="img/image.ext" alt=" alternated label">
E.g. <img src="img/zerg.gif" alt="my photograph"> for an image with GIF format.
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P32/65
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 32/65
6.2.3 photo (C:\Program Files\EasyGuppY\www\…\photo\)
To place the photographs of the diaporama* (! GuppY does not manage the sub-directories. You will
have to deposit all the photographs in bulk in the photo folder).
a) Simple management of photograph
1st box " photo area" ticked in "Services Config "
The diaporama of GuppY automatically detects the presence of deposited images in this folder and
will propose them for displaying. You do not do anything to inform.
b) Management of sophisticated photograph
The two boxes of the " photo area " can be ticked in "Services Config "
In the " Photo" area of the admin, you will have to allot a category, a name and a description with each
photography. The management of the photorama thus more complex, but is classified.
6.2.4 pages (C:\Program Files\EasyGuppY\www\…\pages\)
Place your external webpages here.
You will refer then to a file via the following HTML tag:
<a href="pages/pgweb.ext" title="Text which appears in an info-bubble" target=_blank >text</a>
where « pgweb » is the name of your file and « .ext » its extension.
E.g. <a href="pages/zerg.html" title="Open in a new page" target=_blank >zerg</a> to display the
webpage named "zerg" in a new window.
In this folder, the page " sample.php" proposes to the not-beginners a gauge to integrate external pages
into GuppY within the central framework of the portal (! Knowledge in PHP, HTML is necessary)
6.2.5 Notice
In the shown path (C:\Program Files\EasyGuppY\www\…\file\), the 3 points («\…\» ) represent thefolder in which you work.
Thus, the complete path will be for example:
C:\Program Files\EasyGuppY\www\GuppY\file\
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P33/65
6 3 M t t l f th t t
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 33/65
6.3 Management tools of the content:
Those are detailed in the following table page.
Note that, in certain headings, appear the following options:
[delete] : remove the object of the list but does not destroy it definitively (go in " Maintenance " with
this intention).
[ visible object] : makes the object visible for the visitors of the site.
[ invisible object] : makes the object invisible for the visitors of the site.
[modify] : allows to modify the contents of the object.
Likewise, a button offers the possibility to execute more than one action at the same time (check
boxes) :
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P34/65
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 34/65
Area Function
Homepage When the visitors arrive on the homepage, it is this text which they will see.
It is a good idea to modify it from time to time
News Manage here the news of your site. Do not forget that the number of news posted on the banner page is defined
in " homepage config ".
Articles Manage your articles here.
Tips: the articles are posted initially by category then by title, always alphabetically. Also you can number them to
arrange them in the order which you wish.
You can improve the presentation of your articles using HTML tag (although that is not at all essential). See in
chapter 6.6.
Articles Reactions Manage here the messages left by the visitors in reaction of your articles. Do not hesitate to remove thesentences which do not follow the "charter of the Net" ( racist matter, abusive, coarse words…).
Special When the visitors arrive on the banner page, it is this text which they will see in the Spécial box.
Photos Manage the photographs here.
Download Manage here the files which you want to offer for download to your visitors.
It is strongly recommended to store them in the « file » folder (via the icon of Files administration).
Links Manage here the links towards other sites. Possibility to create categories.
FAQ FAQ stands for 'Frequently Asked Questions'.
In short, it is here that you put the play of questions/answers which arrives to you regularly. Possibility of
classifying the FAQ by categories.
Guestbook Manage here the messages left by the visitors on the guest book of your site. Do not hesitate to remove the
sentences which do not follow the "charter of the Net" ( racist matter, abusive, coarse words…).
Forum Manage here the messages left by the visitors on the forum of your site.
Do not hesitate to remove the sentences which do not follow the "charter of the Net" (r racist matter, abusive,
coarse words…).
Forum Topics Manage a forum containing up to 12 subjects of discussion.
Poll Manage a poll up to 10 answers!
Free Boxes The free boxes are additional boxes (four).
Banners Manage here the commercial banners which will appear in top of your Web pages. A banner is taken randomly
with each page displaying. The "Flash " format is now supported.
Quotations Manage here the quotations which will appear in top of your Web pages.
A quotation is taken randomly with each page displaying.
Tips avoid the jumps with the line in the quotation which will lower as much the height available for the remainder
of the site. Try to make hold the quotations on only one line, as short as possible.
Page footer This piece of page will appear in bottom of al l the pages.
Recommend You can follow and read here the messages of recommendation sent by the visitors of your site with their friends.
Counters Manage your counters here (reset to zero, boost them…)
Statistics Allows to visualize the frequentation statistics of the site and their analysis. Possibility of purging the statistics
(reset to zero).
Newsletter This page gives access to the various phases of preparation and sending of your Newsletter (list of the
subscribers, to write Newsletter and to send Newsletter). This one can now be sent to HTML format.
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P35/65
Area Function
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 35/65
Area Function
RSS news RSS stands for Really Simple Syndication.
You can manage here the publication of contents of partner sites which manage this standard publication format,
like GuppY does for the news.
Logs You can configure (a number of logs, pages to be supervised) or visualize your logs, i.e. to fol low accesses toyour site (date, hour, IP address of the visitor, URL of source, country, host/robot, browser used).
Fi les If your host al lows it ( Ask your host about it), you directly send from your computer to your site (= upload)
images, photographs…, without using your ftp client.
Planner Choose a date and write the text of the event. The box "Calendar" underlines then the current date concerned. A
click on a date displays the event on central page.
Blog There you can manage your blog, and add a note.
Blog Comments Manage comments posted by the users of the blog.
RSS Blog You can manage here the publication of partner's website content that use this standard publication format, asGuppY does for the news.
6.4 The GuppY editor
6.4.1 Its qualitiesAllow an easy formatting of the text you want to write.
A complete and complying standard editor is systematically used and runs the WYSIWYG («What
You See Is What You Get» editor in a «popup» window. Select one of the following in «admin |Services config» :
✔ «No» : is the old editor (only for Internet Explorer) that runs in a «popup»
✔ «Yes, FckEditor» : It's FckEditor that directly runs
✔ «Popup FckEditor» : FckEditor runs in a popup by clicking on a button.
FCKeditor is a WYSIWYG editor that automatically changes all that is written to XHTML correct
code.
As a consequence, you can easily write and manage your article as if you were using a classical text
editing software.
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P36/65
FCKeditor is compatible with Mozilla Firefox Netscape and Explorer browsers Moreover it offers
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 36/65
FCKeditor is compatible with Mozilla, Firefox, Netscape and Explorer browsers . Moreover, it offers
the possibility to insert «Flash» code.
Take care, FckEditor works correctly only if URLs are correctly input in «admin |General Config».
A simple click on the button «WYSIWIG editor» opens FCKEditor in a «popup» :
6.4.2 Relative path and absolute path
The path of the image, if you work locally, is an absolute path, therefore in direct connection withthe environment in which you work : thus, it will refers to various files of your hard disk and will
have an aspect of this kind :
«C:\Program Files\EasyGuppY\www\...\img\myimage.gif »;
On line, it will be enough to have the path into relative which refers to the file in which the imageis. Consequently, the access path will looks like this : "img/myimage.gif "
Fortunately, GuppY deals with you: during the recording with the editor, the path is automatically
brought back into relative (thanks to the URL of your site recorded in "General config"). Thus, anarticle created locally does not need to be worked over again. It is just enough not to forget to also
transfer the image in the adequate folder, to compare the URL of the inserted image with the site's
URL and, if there is equality, to remove this URL to only preserve:
<img src="img/zerg.gif" alt="my photo">
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P37/65
6 5 Activation service:
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 37/65
6.5 Activation service:
Do not forget to activate the requested services (for example, during the creation of a free box, a
banner…) in « Admin | Services Config », otherwise these will not appear on your page.
The positioning of the side boxes is done in « skin Configuration | Boxes Config ».
6.6 How to organize your articles:
By default, the articles which one writes are initially sorted by category then by title, and always
alphabetically.
This alphabetical classification by default is sometimes without incidence, but in the event of chronological presentation, of the type " Introduction – Development- Conclusion ", an alphabetical
classification is catastrophic, since the Conclusion would precede the Introduction.
In similar case, one will thus numbers the items in the order where one wishes to see them following
one another.
This classification is however problematic: indeed, if the articles in this way are numbered: 1, 2, 3,
when one arrives at 10, the article n°10 pass in front of the article n°2.
To avoid that, you can:
• to increase the number of headings and to put less articles by heading;
• to use a really alphabetical classification: letters instead of figures (A, B, C…). That neverthelessleaves you a margin of 26 articles.
• to number your articles from 01 to 99 (for less than 100 articles), or from 001 to 999 (for morethan 99 articles)… It is a solution satisfactory, but not very gracious.
The disadvantage of these operators of classification is to occupy width space in the already narrowarticles boxes.
There is a miraculous alternative solution, puffed up by a Russian speaker on the GuppY forum: it
consists in masking classification with comments tags <!-- 01 -->, <!-- 02 -->, etc.
The classification takes place thus in writing pad and it will not appear with the screen.
The same solution can be used to treat on a hierarchical basis the articles categories: attention,
because it is then necessary to reflect the number of classification encapsulated in the tag of comment
in each article present in the category, and not to only one item.
6.7 The «Blog» Tool:
Since 4.6 version, GuppY includes a Blog tool : you can then change your web portal into a true blog
with notes posting (You or your visitors), reactions, comments... All blog's function are available :
global list, categories list, last notes, last comments and archives (days or months)
You can have your blog «free», «post after validation» or «locked».
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P38/65
Different categories can be created by the admin. Of course, in each ones you can post notes.
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 38/65
Notes will be classified in such a way that the most recent one will be on top.
Displaying a note let the possibility to post a comment. Use your pseudo, an email and write thecomment, then click on «Send». The webmaster can delete a comment if needed.
Visitors can submit a note («Post a note» button): use your pseudo, an email, choose a category and
give a title to your note. When posted, a message will warn you that your note will be published assoon as the webmaster validates it.
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P39/65
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 39/65
Other elements are available on the page :
Rubrics Archives
Last notes Last friend's notes (RSS)
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P40/65
7
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 40/65
7
About plugins
GuppY is provided with some very simple plugins for example: Clock, Mind (= Riddle) and Speed.
You will find more details on this subject and a crowd of plugins to be downloaded on GuppYLand(http://www.guppyland.org)
Attention, it is appropriate to check well the version of GuppY to which the plugin is attached. Some
are not compatible any more with the new version (but will undoubtedly be very quickly, the
developers of plugins being very active).
In all the cases, always read attentively the " Read me " file who comes along each plugin. Thatwill avoid you getting many problems.
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P41/65
8
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 41/65
8
Uploading GuppY on line
8.1 Web host and PHP
First of all, it is necessary that you check whether your host manages the PHP script language (if youdoubt, ask them about it ). Possibly, it is necessary that you activate the PHP, because certain hosts donot activate it out of standard. Check this with your host.
8.2 File transfer (ftp)
If the PHP is accepted, it is enough to copy all the unzipped GuppY files in your personal Web space.
Use a " ftp client * " program (there are excellent and free ones like FileZilla or Gftp included in theUbuntu-Linux distribution) :
• Unzip files on your hard disk ;
• Transfer the whole of them to your Web space ;
Check, using customer ftp, if files contain well all your data (thus no file with 0Kb apart from the files
which are 0Kb originally, namely: SEE on the forum of the official site).
It happens indeed that the transfer is stopped or corrupted: you will then have error messages of the
type : «Transfer cancelled », «critical transfer error », «Too much tries»... But sometimes, you will not
be warned that the transfer was degraded. Errors will appear then on your site, without understanding
why.
Where to put the files ?
Either you can put all the unzipped files and folders at the root of your site directly. Your GuppY will
open with the address «http://www.mysite.com».
Or you can deposit these same contents in a folder, "GuppY /" for example, of your Web space: in this
case, your GuppY will open with the address
«http://www.mysite.com/GuppY/ »
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P42/65
8.3 Checking
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 42/65
It does now remain for you to open the browser , to connect you to the network and enter the address
of your site (yes, GuppY knows it since you enter its general address in "admin | Config ").
Your first task will consist in modifying the default password which gives you access to theadministration of your site.
8.4 Chmods & site security
Attention, the text below is only one synthetic note on the "chmods", as on the site security. You
should regularly consult the corresponding sections on the official site of GuppY
(http://www.freeguppY.org).
8.4.1 Chmods
Chmods are permissions you install on files and directories , which constitute the whole of your
GuppY site. They indicate which tasks are authorized, and this for each file of your site. If Chmods
are badly set up, your online GuppY will malfunction and will return to you with error messages of
this type:
Warning: fopen("data/logh.dtb","w") - Permission denied in http://www.mysite.com/inc/functions.php
on line 198
You «chmod» with your ftp client (the procedures depending on your ftp client, consult
documentation relating to this task ). Here are the rights to set up on the files for the Internet server
which require it (not all, for example, one chmod not at Free).
1. CHMOD data/archive/* 666 (the asterisk indicates that you chmod the files contained in «archive/»
folder )
2. CHMOD data/archive 777 (here, you only chmod the folder «archive/»)3. CHMOD data/cache/* 666
4. CHMOD data/cache 777
5. CHMOD data/usermsg/* 666
6. CHMOD data/usermsg 7777. CHMOD data/* 666
8. CHMOD data 777
9. CHMOD admin/mdp.php and action.php 666 ou 777
10. CHMOD admin/redac 7777
11. CHMOD skin/ 77712. CHMOD skin/name_of_the_skin 777
13. CHMOD skin/name_of_the_skin/* 666
To learn more about chmods, consult the complete tutorial on the official website.
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P43/65
8.4.2 Security
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 43/65
!!! As soon as your site is online, REMOVE INSTALL/ folder .
If you omit to do it, your site could be emptied during 1 second by carrying out the script of
installation.
That happens only to others but the destiny see it differently ... and today it is your turn ! Your site is
disfigured by a hacker. Be happy he could have erased its contents! Do not try the devil! The prevention is a good reflex to acquire.
GuppY is a product developed in PHP, which enables it to be fast and interactive, but it can leave
open exploitable faults by badly disposed people…
How long did you conceive your site? two days, one week, one month ? One will not have more than
30 seconds to an average hacker to reduce to zero all your efforts! That gives matter to reflection …Protect your documents, the access to your site administration and certain sensitive contents , using "
htaccess " protection . Consult the heading " Make safe your site " on the official site.
!!! The security is not to take with the light one, and this some is the size of your site. Theexamples of "visited", "damaged" or "destroyed" sites are unfortunately numerous !!!
More information of safety on the excellent site «CyberMédiaConcept» of my friend B@lou (in
French ):
Whatever, your host can provide you good advises !
Indeed, in this domain, each one follows its own way, so do not hesitate to ask them about htaccess
security and more.
Moreover, there is no perfect security, but it seriously complicates hacker's tasks. Then, never forget
the golden rule in informatics :
BACKUP FILE = SAVED FILE !
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P44/65
9
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 44/65
9
Working online
9.1 Online? Did you say "online" ?!?
Yes of course !!! And it is even the most interesting function of GuppY!
Imagine for one moment… you are somewhere, anywhere but not on your premise. And it isnecessary for you absolutely to add an element to your Web site. There is not to discuss, it is too
significant and that must imperatively be done. But how ? To go back home? Pfff… it is too far, I do
not have time…
No panic, you find a computer connected to the network and… hop, it left! It is enough to go to the
address of its site, to click on the "admin" button , to enter its password and… miracle! You can with
leisure modify your site, to add elements to it…Brilliant, isn't it?!?
Of course, do not forget to disconnect you after your work ("disconnection" button of GuppY),
otherwise the following person will have access to the administrative part of your portal and will be
able to thus modify it !!!
Tips:
if you have a slow modem connection, do not hesitate to prepare your article off line (using the
Notepad of Windows ®, for example). It will not remain you whereas with the "copy/paste" online.
Important note:
GuppYest a site which lives in real time by the additions in the guest book, the forum, the
recommendations with a friend, the counter of visits, proposals of news…
This is why we recommend to build your first GuppY locally, to put it online, then to carry out all the
later modifications online.
9.2 Installing directly GuppY online
Version 4.6 is equipped with contents of demonstration. This one must lead you to be familiarized
with GuppY first of all.
In all the cases, check well the "chmods" and the "security"
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P45/65
9.2.1 Installation in "demonstration" mode
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 45/65
Transfer all the files to your webspace from your computer as explained in chapter 8.
! Your first task must consist of the modification of the password "admin ". By default, this oneis " pass "!
If the situation is appropriate to you perfectly thus, do not forget to remove the directory /folder
"install/ " now. If not any person who would carry out it would destroy all the contents of your Website!
9.2.2 Clean installation
The clean installation makes it possible to remove the contents of demonstration and to start with a
GuppY site empty of datas.
Starting with the install
The starting point of this clean installation can take seat at any time between the first installation and
the state of your base of demonstration with its contents which you could modify.
This installation will destroy all the contents and will keep the parameter setting which you could
carry out in the differents "Config " ( «admin» area).
The clean installation is done via the link «Setup YOUR GuppY|Installation/Migration» of the«Technical» box or by writing http://www.mysite.com/install/ in the address bar of the browser where
(http://www/mysite.com/ is your website URL).
That leads to open the following dialog box:
The button " Prepare your GuppY " causes to display a new screen in which is necessary to click on
"Go ", then to choose "Clean Install " and follow the instructions.
Here, now you really use YOUR GuppY!
Warning, this clean installation does not modify your password . This one is crushed only when
one reloads or replaces by ftp the file " / admin/mdp.php " (this procedure enables you to recover your
"admin " access if you forgot your password… but finally, try to remember, it is more practical).
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P46/65
Removing the install files
In the window which opens at the end of the clean install select the radio button "Deletion of install
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 46/65
In the window which opens at the end of the clean install, select the radio button Deletion of install
files" and follow the instructions.
You ensure whether all the files in the directory /folder "install/ " were indeed removed (or
emptied of their contents because certain hosts do not accept the removal by PHP – but there remainsto you the possibility of removing this repertory via ftp manually ;-). If not, any person who would
carry out the installation would destroy all the contents of your Web site in a few seconds!!!
9.3 The online version migration
GuppY is a Web portal which evolves much and the new versions are frequent. Fortunately, the
passage from one version to another is easy. For that, the same type of window that for a cleaninstallation is available. Simply, it will be necessary to choose the " Migration " option.
Be however attentive to respect certain points:
9.3.1 Preliminary operations
Carry out a complete save of your site (it is never known…), carry out a " integrity check " and ensure
you that it does not produce an error. In the case of error carry out it once again.
9.3.2 Save your data
The data to be preserved are laid out in five directories : «data/ », « file/ », «img/ », « photo/ » and« pages/ ». They thus especially should not be removed!
Also think of saving the favicon, the personal "htaccess " of "admin ", the skins, smiley… which youwould have possibly created.
Note: you can choose to also preserve the file " plugins/ " if those are still compatible with the
new version of GuppY. More precisely, the data of the plugins are located, either under data/plugins/name_plugin /, or under plugins/name_plugin/data/.
9.3.3 Removing and adding certain folders
Remove the files contained at the root of your site (« / ») as well as the directories «admin/ » and «inc/ »,
their contents, their sub-directories and all contents of those.
Copy the new directories and files of the new GuppY version (« / », «admin/ », «inc/ » and «mobile/ ») as
well as the directory "install/ " and its contents.Supplement, if necessary, by your personal additions (plugins, favicon, "htaccess ", skins, smiley…)
9.3.4 Check for the CHMOD
Check if remark "CHMOD" applies to your installation. It is the case if you had to apply it in the
preceding installations/migrations of GuppY.
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P47/65
9.3.5 Launching the migration
Use your browser : if the URL of your site is «http://www mysite com» then write the following text
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 47/65
Use your browser : if the URL of your site is «http://www.mysite.com» then write the following textin the browser : «http://www.mysite.com/install/» and choose the « Migration» option.
9.3.6 Check the parameter settings of the site
Modifications in the parameter setting force to check the sections "Config ", as well as the password.
It will also be necessary for you to make turn a " DB integrity check " to update the index of the
database of GuppY.
9.3.7 Delete the «install/» folder
Once the migration carried out, you must ensure that the directory /folder "install/ " was indeedremoved automatically. If not, any person who would carry out the contents of it would destroy theintegrity of your website !
If you cannot see this directory /folder any more, that wants to say it happened correctly, if not, eraseit via ftp.
9.4 «Offline» => «Online» content update
Sending datas of the local place towards the website must be made with much attention and rigour.
Thus if one returns the contents of "data/ " in entirety, one loses the last modifications which took
place online, i.e. at best information of visit and statistics, at worst of the posts delivers of guestbook,forum, news.
Here a way of proceeding :
Download the directory "data/ " real in local (thus, repatriate the file since the server of your site
towards your computer locally).
Work locally on this basis, to make tests.
As for the modifications, additions and suppressions, they will be done everything in reality (thus
directly on the server, online) with the final one.
For the folders « / », «img/ », « photo/ », « pages/ », et « plugins/ » proceed in different way: : upload* and
download* the necessary elements.
Though it is, do not hesitate to make a backup copy of your current GuppY before anyintervention.
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P48/65
10
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 48/65
10
Portal management
A maintenance? But for what?
Well, a site which does not evolve (very) quickly becomes a site which disappears.Indeed, think of your own experiment of surfing on the Net: do you often turn over on a site which
does not change months since? Well...Not ? And well here, you have the answer to your question:make live your site and the public will return it well to you while coming to visit you regularly.
Work is now facilitated to you by the fact that GuppY integrates an option of maintenance. This one
enables you "to freeze" the portal throughout your work.
You must be recorded as member to put the site in maintenance.
Your portal will be unavailable for your visitors.
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P49/65
11
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 49/65
11
Acknowledgements
11.1 Thanking the author of GuppY and its team
For sure ! Laurent Duveau did a remarkable work, and it makes a free and free software of it. Is thatworth a thank, isn't it?!? Start by visiting his personal site then leave him a message in the guest book,
that always given pleasure (http://www.aldweb.com).
Other developers worked like has navvy for this new major version. Consult without more delaying
the window "About" of your GuppY to know the characteristics of them that do great stuff. Beside, I
want to send a great «THANK YOU ALL !!!».
Let us not forget the abstract team which is given without hoping to offer a software increasingly
more powerful to you and which answers your waiting always more.All this small world can be finds on the official site of GuppY. You will find there their names (or
nicknames), the address of their own site… and they also like to receive a small word in their GuestBook ;-)
Thanks to all members of the GuppY Team
11.2 Want to thank the author of this manual?
I ensure you that it is Laurent in person who insisted that this point appears. Then there… I am a little
constrained.
Whatever, if you want to thank me, simply make climb the statistics of frequentation of my Web site
(http://randorous.free.fr/) and distribute the address around you. Thank you. (Well, obviously, if you
wish to make me a gift of a few hundred euros, do not hesitate, I would not like you ;-).
Thanks to my valuable acolytes of the documentation stream too
11.3 Thank you
Thank you all, users of GuppY, who allow our " fish" of living fully and developing unceasingly..
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P50/65
12
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 50/65
12
The «mobile» folder
GuppY is provided with a mobile version, with reduced displaying.
This one is particularly intended to our friends who are partially-sighted persons, but it will make alsothe happiness of the owners of PDA.
Adapted to the partially-sighted persons? Yes, because those often use voice synthesizers which reads
the page from left to right and convert the writings into audible sounds. The difficulty is that the basic
structure of GuppY comprises boxes, banners… What disturbs the synthesizers which read pieces of sentences of each element (they go from left to right and do not make the distinction of a change of
box).
The mobile version circumvents this aspect of the problem while bringing back the contents in only
one and even page perfectly usable by the vocal computers.
The link towards this version is now integrated by defect in the "Webmaster " box.
If this box is deactivated, it will be enough for you to use the additional sub-directory " mobile/ " with
the address to your site:
«http://www.mysite.com/here/mobile/»
In this case, you will largely facilitate the task of the visitors by creating a link, accessible on the banner page, driving at this address.
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P51/65
13
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 51/65
13
Appendices
13.1 The «Preferences» box
If the " Preferences " box is activated, each visitor can become the member of the site. That confersmany advantages to the member: : his or her pseudo and e-mail is retained, which avoids to him or her having to seize again them with each post; it automatically arrives in the language which is chosen
when the site is bilingual; it positions the boxes with its liking; it selects the skin of its choice to sail
on the site; it has a personalized signature, an avatar and an URL which will be added automatically
to its posts on the forum; finally, it can receive and send mini-messages (in particular via a module of mail posting the messages read and not read).
You can personalize your secret code (5 characters minimum) and use this one to re-register you with
the same name (or pseudo) or to use your name (pseudo) on another machine.
The only condition of inscription is that the browser of the visitor accepts the "cookies *" (this option
is adjustable in the browser parameters).
Note : the cookies are stored only on the computer of the recorded user, it thus does not havethere a possible constitution of lists of members: no possible recovery = respect of your privatelife !
13.2 Compatibility
Linux®, Windows®, Mac OSX®, QNX®, BeOS®.. GuppY adapts to all !
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P52/65
In more of the traditional one Internet Explorer®, GuppY easily functions under other browsers suchas Mozilla ®, Firefox®, Galeon®, Konqueror®, Safari® and Voyageur®.
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 52/65
13.3 GuppY under Macintosh
This tutorial aims to make easier the install and use of GuppY on a MacOSX environment thanks to«MAMP» software..
13.3.1 Install «MAMP»
1. First download the software here : http://mamp.info/en/index.php
2. Click on «Download»
3. Then, you will see the following window :
Did you see what the elephant can do !!! Personally, I cannot do but this is not the subject here. This
step is the most important as you may know that Macintosh has recently provided to the market
computers with new chipsets and new structures . These new macs are known as «Mac Intel». Before
this event, all where known as «PowerPC» («PPC»).So choose carefully the pack corresponding to your Mac or it won't run.
4. Then, lets' go for the download....
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P53/65
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 53/65
5. Ok, now you should have the following icon:
Then you could have an automatic window, if not, just double-click on the icon.
6. You will now see this :
Then «drag&drop» the «MAMP» folder picture onto the «Applications» one.
7. You should then see this :
As soon as the copy is over, you will be into the « Applications » folder
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P54/65
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 54/65
8. Now you will have to place your GuppY folder (with all files and folders). Just open your
«MAMP» folder and you should have the following :
Then, open the «htdocs» folder and copy your GuppY folder as shown below :
It's now over, let's go for use !
13.3.2 Using MAMP
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P55/65
1 Go to the «MAMP» folder (in «Applications») and double-click on the «MAMP» icon to runthe application.
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 55/65
2 Once launched, the following window shows up :
Wait for the two spots to be green.
3 The click on «Open Home Page»
Note : sometimes you will automatically be on the home page, so wait a little...
4 The Home page should look like this :
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P56/65
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 56/65
You might see a strange URL on top : http://localhost:8888/MAMP/?language=French. Don't
be afraid, «http://localhost» means that your are on your local host and the 8888 number is your
host port. Indeed, your address will always begin with: http://localhost:8888/. Then complete it
with the name of your folder placed within the «htdocs» folder.
As for example, we have placed GuppY in the «htdocs» folder, so we write the URL like this :
5 Then press Enter and look at your wonderful GuppY ready to be used !
Note : you can place many GuppY in «htdocs». Just create many folders, like guppy-daddy, guppy-mummy, guppy-kid, etc. Then write it in the URL : http://localhost:8888/guppy-daddy
13.4 GuppY and LinuxThis tutorial aims to make easier the install and use of GuppY with Linux. Explanations are given for
«Ubuntu Edgy Eft» (Tested with «Linux Mint Béa» too).
! Test this process at your own risks !
! Processes made as «root» are always risked !
13.4.1 Installation of a Web host, Apache, Php and MySql with Linux
We have chosen «XAMPP».
You can easily find a tutorial on the net.
Nevertheless , I pinpoint the Xampp stop process. Open a terminal and code the following :
sudo /opt/lampp/lampp stop
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P57/65
You should see this :
Stopping LAMPP 1.5.5a
LAMPP: Stopping Apache...
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 57/65
LAMPP: Stopping Apache...
LAMPP: Stopping MySQL...
LAMPP stopped
Xampp is now stopped.
13.4.2 Installing GuppY with Xampp
We will create a «guppy» folder in a folder known by Xampp :
• Open «nautilus» in «root» mode (command «gksudo nautilus»)
• Display the hidden files (CTRL+H)
• Go to «/opt/lampp/htdocs/»
• Right-click on it and choose «New | folder»
• Name it «guppy»
Now you have to determine rights :
• Right-click on «guppy»
• In the opening window, click on «properties»
• Make your choice as shown below
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P58/65
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 58/65
Note : This is the note of the more adequate process. It seems that using a «ftp» software to place
GuppY in the «htdocs» folder is a better choice. I didn't try it as I am the only user of my computer,
that's why I can give all access to a folder.
Note : «Gftp» is include in Ubuntu Linux. You have to write «127.0.0.1» in «Host» and tochoose «nobody» in «User». For password, use «lampp». At last, click on the connection button on the left in order to displaying the «htdocs» folder. Save with «Bookmarks | Add bookmark».
Note : You can install as many folder as you want in «htdocs», just name them differently.
13.4.3 Discovering GuppY with your browser
Open Firefox and write your URL (using the name of your folder in «htdocs», here it's «guppy») :
http://localhost/guppy
13.5 File upload
Certain hosts deactivate the functionality of HTTP loading. The functionality "Files" in the admin is
then unusable .You will thus transfer your files on your site by using your FTP software ..
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P59/65
13.6 Sharing Web contents thanks to RSS format
Certain hosts limit the « PHP include()» function to access the internal files only on the site, and the
access to the files of another Web site does not allow. In this case, the module of division of news to
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 59/65
format RSS will not run: you will not be able to publish wire RSS on your site .
13.7 CeCILL Licence and GFDL
This whole manual is subjected to GNU Free Documentation License (GFDL), what means :
➢ that any person has the right to freely use the manual.
➢ that any person is authorized to spread the manual.
➢ that whoever can modify the handbook freely by respecting GNU FDL licence (inter alia, the name
of the preceding writers must be reproduced on any modified document).
For more information, consult :
The Free Software Foundation (FSF) website which is at the origin of this type of licence :
http://www.fsf.org.
You can also contact them by traditional mail : Free Software Foundation, Inc. 59 Temple Place,
Suite 330, Boston, MA 02111-1307 USA
Licence GNU FDL is detailed in a text file (copyright-gfdl) accompanying documentation at the timeof its downloading. Read this licence attentively!
For information and comprehension, a French translation of this one is placed at the disposal under
the name copyrightFR-gfdl11 on http://randorous.free.fr.
However, only the last English version has official value.
The GuppY software is subjected to the CeCILL licence. You will find more details about this in the"readme.txt " file.
13.8 Lexicon
Alias: Object pointing towards another, to have access to this last from a moved place.
E.g.: for the electronic mail, it is about an address created starting from an existing address, but which
is entirely dependent on this one. It is in fact the same address, but under a different name.
BATCH : File containing a whole of orders which will be treated automatically ("batch processing")as if they had entered to the keyboard by the user, one after the others.
BLOG : Website where one or more people freely express on a certain periodicity. His or her
expression is divided in chronological units; Each units can be commented and often enhanced with
external links
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P60/65
Compression: The compression of a file makes possible to reduce its size by mathematical
algorithms (the most known format is the zip format). Decompression is the operation allowing the
files compressed to find their initial size.
Field: A zone of recording indicated for a certain category of data A field generally indicates a white
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 60/65
Field: A zone of recording indicated for a certain category of data. A field generally indicates a white
box in which it is possible to write.
Ftp client: Software installed on a computer and allowing the file transfer thanks to the FTP* protocol .
Cookie: Short character string deposited in a file of your computer by your browser W3. The
"cookies" are especially used to store an permanent or temporary information (the date and hour of your visit, a response to a form which you filled on the visited site, personal information collected by
the server, etc).
Diaporama: A whole set of images that one can make ravel one following the other (~photorama).FAQ: Acronym for Frequently Asked Questions, heading presenting by subjects the questions most
frequently asked by the users, accompanied by the corresponding answers.
FTP: Acronym for File Transfer Protocol (protocol for file trasfer t), protocole Internet permettant
aux utilisateurs d’échanger des fichiers entre ordinateurs.
Identifier(or login) : Name of user or identification number to be identified on a server.
To increment: to increase by definite steps (E.g.: by step of 1 : x ; x+1 ; x+2 ; etc.).
User Interface : Visible part of a software by the user, in other words the program managing the
interaction between the machine and the user.
Script language: Shortened programming which allows experienced users to create on their computer
rich contents and which offers to the programmers rapidly to create simple applications.
MySQL: System of management of relational databases very much used to put online databases.
Package: A package is a regrouping, on the same support, of a whole of elements. File containing
software in a format allowing an easy installation (or a deinstallation).E. g.: EasyPHP official package.
Interpreted pages: Pages "understood" and displayed by the adequate software (in fact, via the "local
Web").
Pixel: Luminous not posted by your computer.
Portal: A page of entry of Web site offering the maximum of links towards the various parts of this
site or other sites.
RSS (format) : RSS meant initially «Rich Site Summary» but the acronym is often interpreted like"Really Simple Syndication" (one speaks in general about "syndication of contents" to indicate the
possibility of republishing on a Website of the contents coming from another Website). RSS is a
means of posting the news published on a friendly site.
Script: A whole set of orders able to automate certain tasks of a communication program.
Skin : a whole set of parameters and images defining the appearance of an application.
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P61/65
Web server: Computer, or its software, which "serves" other computers on a network by managing
the files and the operation of the network.
Site Portal: It is a generic term to indicate a site which is used as entrance point on Internet for a
significant number of users
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 61/65
significant number of users.
SPAM: Spam (or spamming, pourriel, junk email) is the action to send electronic mails (e-mail) withan advertising or promotional aim, which they are commercial or not, and in general in great number,to people who did not request it.
Tag: Specific codes used to format documents HTML Marks used in a text to announce to the
program which specific order must be carried out.
Download: Procedure aiming asking for and at transferring a file of a distant computer towards a
local computer, then to save this file in the local computer.
Upload: Procedure aiming at transferring a file from a local computer towards a distant computer (aserver generally), then to save this file in the distant computer.
Pixel: Luminous not posted by your computer.
Portal: A page of entry of Web site offering the maximum of links towards the various parts of thissite or other sites.
RSS (format) : RSS meant initially «Rich Site Summary» but the acronym is often interpreted like
"Really Simple Syndication" (one speaks in general about "syndication of contents" to indicate the
possibility of republishing on a Web site of the contents coming from another Web site). RSS is ameans of posting the news published on a friendly site.
Script: A whole of orders able to automate certain tasks of a communication program.
Skin : a whole of parameters and images defining the appearance of an application.
Web server: Computer, or its software, which "serves" as other computers on a network by managing
the files and the operation of the network.
Site Portal: It is a generic term to indicate a site which is used as entrance point on Internet for asignificant number of users.
SPAM: Spam (ou spamming, pourriel, junk email) is the action to send electronic mails (e-mail) with
an advertising or promotional aim, which they are commercial or not, and in general in great number,with people who did not request it.
Tag : Specific codes used to format documents HTML Marks used in a text to announce to the
program which a specific order must be carried out.
Download: Procedure aiming asking for and at transferring a file of a distant computer towards alocal computer, then to save this file in the local computer.
Upload:Procedure aiming at transferring a file from a local computer towards a distant computer (aserver generally), then to save this file in the distant computer.
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P62/65
13.9 A little advertisement...
Bruno Dekeyser has created other publications :
On line :
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 62/65
L'Authentique et Vraie Histoire Inventée de GuppY (T1 & 2).The Official and True Invented Story of GuppY.
Le Livret de Suivi des Élèves.
Le Tryptique de présentation de GuppY.
Le guide des produits dérivés de GuppY (CDROM, jaquettes, affiches...)
Le guide utilisateur BookDB.
Scribus, manuel d’utilisation sous windows.
Aide-mémoire Ubuntu Linux.
Out line :
«Impulsions», manuels de Sciences et Technologies (éditions Wolters-Plantyn - Belgique).
13.10 Manual updates (v4.0 => v4.6)
➢ Page-setting of the manual was entirely reconsidered and allows a recto-back impression of quality. It is consequently possible to connect it (spiral, hot...) while preserving a perfect legibil
➢ In-depth modification of the structure of the manual : additions, modifications and removal of chapters, order of appearance of those modified...
➢ A «Macintosh» section added
➢ A «Linux» section added
➢ Summary integrated
➢ Summaries linkable
➢ Screenshots modified.
➢ «Setting parameters» section updated
➢ «GuppY Editor» section updated
➢
More details in the forum section➢ New information about «Blog»
➢ Lexicon update
➢ Various little changes
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P63/65
14
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 63/65
Table of contents
GUPPY................................................................................................................................................... 1
CONTENTS............................................................................................................................................ 3
USE OF THE MANUAL.......................................................................................................................... 5
INTRODUCTION ................................................................................................................................... 6
1.1 An extract of the "Read me" file..................................................................................................................... 6
1.2 What's news in this 4.6 version ?..................................................................................................................... 6
THE GUPPY«LOOK» ............................................................................................................................ 7
HOW TO FIND AND INSTALL GUPPY................................................................................................. 8
WORKING WITH GUPPY «IN LOCAL»................................................................................................. 9
4.1 About PHP......................................................................................................................................................... 9
4.2 EasyGuppY Installation................................................................................................................................... 9
4.3 Launching EasyGuppY.....................................................................................................................................94.4 Using the www folder......................................................................................................................................10
4.5 Keep in mind....................................................................................................................................................10
4.6 Configuring GuppY........................................................................................................................................ 11
SETTING OF PARAMETERS.............................................................................................................. 13
5.1 Theme Config...................................................................................................................................................14
5.2 Look Config..................................................................................................................................................... 15
5.3 Boxes config..................................................................................................................................................... 16
5.4 Generate CSS...................................................................................................................................................17
5.5 General management...................................................................................................................................... 18
5.6 Services Config ............................................................................................................................................... 21
5.7 Areas Config.................................................................................................................................................... 23
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P64/65
5.8 Homepage Config............................................................................................................................................ 24
5.9 Forum Config ..................................................................................................................................................24
5.10 Forum archiving............................................................................................................................................26
5 11 Members zone managing 26
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 64/65
5.11 Members zone managing.............................................................................................................................. 26
5.12 Permits............................................................................................................................................................26
5.13 Password:.......................................................................................................................................................28
5.14 Integrity check ...............................................................................................................................................28
5.15 Maintenance...................................................................................................................................................29
5.16 Working..........................................................................................................................................................30
5.17 About.............................................................................................................................................................. 30
MANAGING THE CONTENT OF GUPPY............................................................................................ 31
6.1 The running principle of GuppY................................................................................................................... 31
6.2 You have four folders to pose the specific objects........................................................................................31
6.3 Management tools of the content:..................................................................................................................33
6.4 The GuppY editor........................................................................................................................................... 35
6.5 Activation service:...........................................................................................................................................37
6.6 How to organize your articles:.......................................................................................................................37
6.7 The «Blog» Tool:............................................................................................................................................. 37
ABOUT PLUGINS................................................................................................................................ 40
UPLOADING GUPPY ON LINE........................................................................................................... 41
8.1 Web host and PHP.......................................................................................................................................... 41
8.2 File transfer (ftp).............................................................................................................................................41
8.3 Checking...........................................................................................................................................................42
8.4 Chmods & site security................................................................................................................................... 42
WORKING ONLINE............................................................................................................................. 44
9.1 Online? Did you say "online" ?!? .................................................................................................................44
9.2 Installing directly GuppY online....................................................................................................................449.3 The online version migration..........................................................................................................................46
9.4 «Offline» => «Online» content update.......................................................................................................... 47
GuppY, the Manual v 4.6 - © Bruno Dekeyser - 28/07/07 P65/65
PORTAL MANAGEMENT.................................................................................................................... 48
ACKNOWLEDGEMENTS.................................................................................................................... 49
11.1 Thanking the author of GuppY and its team..............................................................................................49
5/17/2018 GuppY Manual v46 - slidepdf.com
http://slidepdf.com/reader/full/guppy-manual-v46 65/65
g pp
11.2 Want to thank the author of this manual?..................................................................................................4911.3 Thank you...................................................................................................................................................... 49
THE «MOBILE» FOLDER.................................................................................................................... 50
APPENDICES....................................................................................................................................... 51
13.1 The «Preferences» box..................................................................................................................................51
13.2 Compatibility................................................................................................................................................. 5113.3 GuppY under Macintosh..............................................................................................................................52
13.4 GuppY and Linux..........................................................................................................................................56
13.5 File upload......................................................................................................................................................58
13.6 Sharing Web contents thanks to RSS format............................................................................................. 59
13.7 CeCILL Licence and GFDL.........................................................................................................................59
13.8 Lexicon........................................................................................................................................................... 59
13.9 A little advertisement....................................................................................................................................62
13.10 Manual updates (v4.0 => v4.6)...................................................................................................................62
TABLE OF CONTENTS....................................................................................................................... 63