65
5/17/2018 GuppYManualv46-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

GuppY Manual v46

  • Upload
    coti-ul

  • View
    59

  • Download
    0

Embed Size (px)

Citation preview

Page 1: 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

Page 2: GuppY Manual v46

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 .

Page 3: GuppY Manual v46

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

Page 4: GuppY Manual v46

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

Page 5: GuppY Manual v46

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 :

Page 6: GuppY Manual v46

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!

Page 7: GuppY Manual v46

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.

Page 8: GuppY Manual v46

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.

Page 9: GuppY Manual v46

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.

Page 10: GuppY Manual v46

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).

Page 11: GuppY Manual v46

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:

Page 12: GuppY Manual v46

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).

Page 13: GuppY Manual v46

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»

Page 14: GuppY Manual v46

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.

Page 15: GuppY Manual v46

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.

Page 16: GuppY Manual v46

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 !

Page 17: GuppY Manual v46

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 !

Page 18: GuppY Manual v46

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).

Page 19: GuppY Manual v46

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.

Page 20: GuppY Manual v46

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.

Page 21: GuppY Manual v46

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 :

Page 22: GuppY Manual v46

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...

Page 23: GuppY Manual v46

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

Page 24: GuppY Manual v46

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

Page 25: GuppY Manual v46

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

Page 26: GuppY Manual v46

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

Page 27: GuppY Manual v46

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

Page 28: GuppY Manual v46

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

Page 29: GuppY Manual v46

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

Page 30: GuppY Manual v46

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

Page 31: GuppY Manual v46

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

Page 32: GuppY Manual v46

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

Page 33: GuppY Manual v46

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

Page 34: GuppY Manual v46

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

Page 35: GuppY Manual v46

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

Page 36: GuppY Manual v46

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:

Page 37: GuppY Manual v46

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.

Page 38: GuppY Manual v46

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

Page 39: GuppY Manual v46

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

Page 40: GuppY Manual v46

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

Page 41: GuppY Manual v46

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

Page 42: GuppY Manual v46

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

Page 43: GuppY Manual v46

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

Page 44: GuppY Manual v46

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

Page 45: GuppY Manual v46

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

Page 46: GuppY Manual v46

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

Page 47: GuppY Manual v46

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

Page 48: GuppY Manual v46

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

Page 49: GuppY Manual v46

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

Page 50: GuppY Manual v46

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

Page 51: GuppY Manual v46

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®.

Page 52: GuppY Manual v46

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

Page 53: GuppY Manual v46

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

Page 54: GuppY Manual v46

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.

Page 55: GuppY Manual v46

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

Page 56: GuppY Manual v46

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...

Page 57: GuppY Manual v46

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

Page 58: GuppY Manual v46

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

Page 59: GuppY Manual v46

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

Page 60: GuppY Manual v46

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

Page 61: GuppY Manual v46

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 :

Page 62: GuppY Manual v46

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

Page 63: GuppY Manual v46

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

Page 64: GuppY Manual v46

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

Page 65: GuppY Manual v46

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