September 10 2010 00:35:48
Navigation
IRC Channel
Want to chat?
Join our IRC channel at:
irc.freenode.net #phpfusion

Freenode Webchat

Free IRC Clients: Wikipedia
Support Sites
Donate
How to modify PHP-fusion
Intro:

PHP-Fusion is/has been developed by Nick Jones, owner of this very site and this system.

I myself started using this system 30th of October 2004 - the purpose was to build my own site - easy with this kinda setup. I needed it modified a bit to fit my needs, so I went to the supportsite in Denmark and also this site, asked HOW TO and got my answers straight up.

As i modified my own site, I helped others out and had the kick of being ABLE to see some pieces of code that I could flip around and make something usefulof to others - also meant that my own site was modified over and over again, for test-purpose, (still is, he he).

I agreed to run a danish MOD-site with another member of this community - lotsa work, making a lot of new stuff - too much almost.

Where am I at now?

Setting up bigger sites for ppl, making "deeper" infusions than earlier - still learning about PHP and MySQL, didn't now anything till I got this splendid system, only few snippets of HTML - not worth mentioning really.

Anyways - my input for HOW TO:

PHP-Fusion (PF from now on) is a multilingual system, meaning that you can chose between a lot of languages. If a language is not done already, it's "just" to make a new set of language files in required language - upload and change settings to the new language uploaded.
The language files to the WHOLE system is located in ROOT\locale\. Keep it in mind as you read on.

Let me start with folder and file structure at first:
(I will explain how to find the right files to modify later on)

*****
ROOT\administration\
Contains all files used in the administration section for admins and superadmins. Also contains the backup of your site in ROOT\administration\db_backups\
Images that are used in adminpanel in admin section is placed here also, in ROOT\administration\images.


*****
ROOT\forum contains the files used in forum or discussion group if you like. The attachments to threads that members posts are put into ROOT\forum\attachments.

*****
ROOT\images has several sub folders for each their purpose. Let me explain.

ROOT\images itself, contains basic images used for different purpose, banner, validationcode etc.

ROOT\images\articles is the folder to use to upload pictures to, for the purpose of making articles.

ROOT\images\news - same thing as above, but for news.
Next cpl of folders are different.

ROOT\images\avatars is where members avatars are uploaded when a member add an avatar to their profile.

ROOT\images\smiley is where you find default smileys used in PF - they can be chaged as you like, but adding MORE would take some coding work in dif. files.

ROOT\images\photoalbum is the place where uploaded images being used in the section photoalbum, are uploaded.

ROOT\news_cats is a new folder that arrived with 6.00.203 version recently. It contains some premade images that are used when categorizing news in admin section - more can be added.

*****
ROOT\includes are a special folder that are made for special features that request some deeper kind of kode. E.g. the mail-feature in the system, the TinyMCE and so on. Files from here should not be modified. These files are used in complex features in PF and they are "included" - important for other files in this system, for doing a "job" in a certain matter.

*****
ROOT\insfusions contains what some would think of as "plugins" - it's Nick Jones term of a plugin. Some are default and included in the basic system you already have. E.g. the navigation panel.
In administration section, system department, you can turn on and off some of these plugins. Not all are to be installed as they are part of basic setup. The idea of infusions are to make it easier for common user to download an infusion at one of the support sites, upload it and "switch" it on, and off you go, installed and ready for usage.
All infusions have their own folder name - note that.
E.g. ROOT\infusions\navigation_panel\ files that makes navigation panel look as it does is put in this folder.

*****
ROOT\locale - now THAT'S what I started with. This folder contains all language files for a given country setup.
E.g. ROOT\locale\Danish\
It contains excactly the same text as ROOT\locale\English,but translated to Danish. Files in each "Country" are named the same.

System imports these language files into the system, meaning that a site could change from German to Polish in a flip, through main settings, language control.
If your language is not included in basic package, but you want it to BE in that language, make a folder ROOT\locale\Yourlanguage - copy all files from a selected language into this folder, take one file at a time and translate it, line by line. When done, go to administration and set the language control to your language.

Everything in this system is based on "softcoded" language files, meaning that you don't have to change any system files at all, just the simple language files for the system to work.
Note that 2 subfolders are here as well. One for admin and one for forum sections.
These are bigger features in this system, and therefore they have their own folders.

*****
ROOT\themes contains different themes or skins if you like. Several to chose inbetween as standard, more to find at theme-support site, PHP Fusion Themes.

As with language, these themes are listed in named folders, one folder for each theme, folder name is the name that is being listed in dropdown menu in main settings. The dropdown reads the folder names and lists them. If you find a new theme you like, upload it to it's name folder, and go to main setting to choose it.

So far the folder structure.
If you only use a particular language, it's OK to delete the others, same thing with the theme folders you're not using.
It will easen up your daily backup if backing up all the time - just leave MAIN language folder, English - in case something screws up in your default language file set, it's good to have ,he he (been there, done that).

TO COME:
Basic files - maincore.php config.php subheader.php index.php
Panels - building, center and left/right.
MySQL structure - some of the tables to be explained.
Making a table on a page - column and rows
MySQL query - how to address a table to get some datas to be shown in a page.
Indusions Development Kit - make your own Infusion - small step by step with a small feature.

For now - enjoy
Søren Lange aka Danish1977
Comments
#1 | donnydave on Oct 23 2005 at 08:47:30
Søren, this is really good, because as a newcomer to PHP-Fusion I am completley lost!
Your article gives an insite into what the various parts of the programme do, and I look forward to your next guide, especialy panels!
Wink
#2 | flyingduck on Nov 03 2005 at 12:26:29
You should definently create more in this! beautifull work søren
#3 | althequick on Dec 05 2005 at 21:41:55
I can only agree my previous speakers. Very nice article, Soren. Pls, contiue Smile
#4 | Danish1977 on Dec 07 2005 at 07:59:05
on to it, lil busy with studies - i'll update this article some more around NY or so...
#5 | bobodog69 on Dec 29 2005 at 13:35:35
Well said donnydave!

I to am new but just love the layout of the site and how clean, uncluttered and well places as well as all the extras. KUDOS to all involved and I look forward in learning more! THANK YOU, THANK YOU, THANK YOU .

HAPPY HOLIDAYS TO ALL
#6 | nawthun on Jan 16 2006 at 09:20:54
Terrific bit of news about Infusions. I was a little confused at first but your article has "smacked me in the head with a hammer!" Thank you very much. Looking forward to more articles from you.
Thank you agao.
Marv
an ole Nebraskan farmboy now living in Rep de Panama
Grin
#7 | eSKape on Feb 01 2006 at 22:03:34
Hey Søren, nice article Smile

I don't know if you have seen www.ravnsbjergkol..., that's pretty nice, and does not 'look' like an php-fusion-page. As mention below, it is only 'based' on php-fusion.

I haven't found any themes out there, that doesnt look like alle the others (except for different border graphics and colors). Do you really have to build the page up by yourself to get a result like Ravnsbjergkollegiets homepage?
#8 | domiz on Feb 05 2006 at 12:22:43
how can i change my site language from English to Lithuanian? Smile
#9 | probase on Feb 17 2006 at 13:31:52
Well i have modified my site in a little bit other way. All PF modules and it's tranclation are now in each module folder. Ex.:
photogallery -> gallery/index.php
gallery translations -> gallery/locale/Lithuanian/
gallery images -> gallery/img/
gallery administration -> gallery/admin/
gallery admin translations -> gallery/admin/locale/Lithuanian/

So i did all modules like this one. It is realy better for me.
#10 | probase on Feb 17 2006 at 13:34:13
Ex site for my mod. : www.xcms.be
Post Comment
Please Login to Post a Comment.
Ratings
Rating is available to Members only.

Please login or register to vote.

Awesome! Awesome! 58% [7 Votes]
Very Good Very Good 25% [3 Votes]
Good Good 8% [1 Vote]
Average Average 0% [No Votes]
Poor Poor 8% [1 Vote]
Login
Username

Password



Not a member yet?
Click here to register.

Forgotten your password?
Request a new one here.
Member Poll
Which PHP version are you using?

4.x or older
4.x or older
7% [26 Votes]

5.0.x
5.0.x
4% [15 Votes]

5.1.x
5.1.x
3% [12 Votes]

5.2.x
5.2.x
26% [97 Votes]

5.3.x or newer
5.3.x or newer
59% [219 Votes]

Votes: 369
You must login to vote.
Started: 15 Jun 2010 23:49:52

Polls Archive
RSS Feeds
- PHP-Fusion News
- SF File Releases
- SF News Releases
Render time: 0.20 seconds - 29 Queries 72,920,544 unique visits