>> Site Map >> News

phpNUKE tutorial in English

#18 - 8--admin--phpNUKE tutorial in English--2003-01-23 13:36:59

#

phpNuke Tutorial ( looks like its out of date now hmm? ....doctornuke 22/10/03)

***Please noted that this article was written since nuke 5.5 *****
Table Of Contents:
(AIM: el2ik E-Mail: el2ik@hotmail.com) ::
1) Downloading Nuke
2) Make sure you have SQL Database
3) Downloading phpMyAdmin
4) Configuring phpMyAdmin
5) Uploading phpMyAdmin
6) Editing "config.php" in your nuke folder
7) Editing "sql_layer.php" in your nuke folder
8) Uploading Nuke & CHMOD Files In FTP
9) Finishing off the install, create super user (admin)
10) Useful tips for setting up your website
11) Themes: Adding, Changing, Deleting
12) Adding pages on your menu ***
13) Making Nuke site yoursite.com instead of yoursite.com/html/
14) Resource Website's for Nuke (Themes, Addons, etc)
15) Recommended FTP Program's and HTML/Text Editors
16) Contact Me for any help, anytime!

-
1) Downloading Nuke

http://www.iawebdesign.com/PHP-Nuke-5.6.tar.gz (my host, dont have to sign up as in phpnuke.org)http://www.phpnuke.org (recommend version 5.6), and unzip it.

2) Make Sure you have SQL Database

Make sure you have a online database, (for those of you on powweb, under ops.powweb.comand add a user, it cost $10)

3) Downloading phpMyAdmin

Download phpMyAdmin-2.3.0 or phpMyAdmin-2.3.1
Go to http://www.phpmyadmin.net/ and click on "Download phpMyAdmin-2.3.1-rc1-php.zip"
Keep folder named as is, the lines in config.inc are the same in both versions.
If you download version 2.3.1, replace all the URL's I wrote with the 2.3.1 folder
(I recommend phpMyAdmin-2.3.0 if you want to follow this tutorial exactly)

4) Configuring phpMyAdmin

In your phpMyAdmin folder, open the config.inc in any text editor or HTML editor (i.eCute HTML, Wordpad, etc)

PhpMyAdmin Settings - Note: Lines are the same for versions 2.3.0 & 2.3.1

Line 39: Between the ' and ' put your URL where you will upload your phpMyAdmin folder too (such as: http://www.yoursite.com/phpMyAdmin-2.3.0).
Line 72: Between the ' and ' put your SQL User name you created on your host.
Line 73: Between the ' and ' put the password for your SQL User name from your host.
Line 75: Between the ' and ' put your SQL database name that you created on your host.Save the file, and close it.

5) Uploading phpMyAdmin

Now, upload the entire phpMyAdmin-2.3.0 folder to your host, and go to:
http://www.yoursite.com/phpMyAdmin-2.3.0/index.php and on the left frame, you should see
your database name, click on it, then at the top there should be 5 options, click "SQL".
At this page, near the bottom, it says, "Or Location of the textfile:", click on browse,
browse your computer to your nuke folder (where you unzipped it earlier), and go to the
"sql" folder, in it should be "nuke.sql", select it, then click "go" or "submit" or whatever
it says. Now you have imported your sql database needed for nuke. Half the battle is over :)

*Note - DO NOT change the folder name for your phpMyAdmin, KEEP IT AS "phpMyAdmin-2.3.0", itwon't work with a changed name.

6) Editing "config.php" in your Nuke folder

Now, on your computer, go to your nuke folder, then go into the "html" folder, now open
the "config.php" file, here are the following lines that you will have to edit:

Line 32: $dbhost = "localhost";     <--- Make sure this line stays as localhost (refers to the server you're on)
Line 33: $dbuname = "SQL User Name";     <--- Your database user name that you created on your host earlier
Line 34: $dbpass = "Password";     <--- The password to your user name from the database
Line 35: $dbname = "Database Name";     <--- Your database name
Line 36: $prefix = "nuke";     <--- Keep as nuke
Line 37: $user_prefix = "nuke";     <--- Keep as nuke
Line 38: $dbtype = "mysql";     <--- Originally "MySQL", MUST CHANGE to "mysql", it is case sensitive and can cause errors

That's all of the editing you'll have to do in the config.php file, save it, and close it.

7) Editing "sql_layer.php" in your Nuke folder

Go back to your Nuke folder on your computer, go into the "Includes" folder, and open:
"sql_layer.php" in your text/html editor. Here you are going to have to use the search option,
(Edit, then search for some), search for "MySQL" and change everything that is "MySQL" to "mysql",
yes, this is case sensitive and must be fixed. Note -- There are some other variations of it, make
sure to JUST change "MySQL" to "mysql", when you are done, save it, and close it.

8) Uploading Nuke & CHMOD Files In FTP

Now here's the waiting part. Go into your FTP, upload the entire "html" folder from your
nuke directory on your computer onto your website, just the "html" folder and all of it's contents.
This may be a long wait (1/2 hour or so common). Remember, by now, you should have edited
the necessary files and overwritted them so when you upload them they are fixed. Now, in
your FTP, you are going to have to CHMOD. If you don't know how, for most FTP programs, you
right click on the file/folder, and go to "Properties/CHMOD", CHMOD all files to 666, and all
folders to 777. I don't believe you have to do everyfile, but it won't hurt. Essential files,
would be ones like "config.php", "sql_layer.php", and all the folders. Once it is done uploading,
and you CHMOD-ed everything, go to the next step.

9) Finishing off the install, create super user (admin)

So, it's done uploading, error free (I hope!), and now what. Well now you will have to
go to this url: "http://www.yoursite.com/html/index.php", it should say "Create A Superuser"
somewhere on the page, THIS IS YOUR ADMIN USER NAME AND PASSWORD, REMEMBER IT. Once you
have created a super user, congrats!!! You have installed phpNuke, and the sky is the limit
from there.

10) Useful tips for setting up your website

http://www.yoursite.com/html/admin.php?op=Configure
Change general options (Title, theme, annoying text at the bottom, etc)

http://www.yoursite.com/html/admin.php (All from the admin page)
Click on the blocks link, de-activate the blocks you do not want (such as, the Amazon one)
Click on the modules link, de-activate and activate the links within your blocks that you want
Click on add story, post's new's on your website
Click on surveys, add/edit/delete the survey on your website

11) Themes: Adding, Changing, Deleting

If you want to change a theme that is already installed in Nuke (comes with around 10),
go to "http://www.yoursite.com/admin.php?op=Configure" and go to "Default theme for your
site:" and just select a new one, and go to save changes.

If you want to add a new theme for your site, you will have to download a theme off of a
website, then upload the whole folder to /html/themes/ in your FTP. Then once it's done
uploading, go back to "http://www.yoursite.com/html/admin.php?op=Configure" and go back
to the "Select theme:" and select the theme you just uploaded, simple as that!

12) Adding pages on your menu

Adding pages on your menu's... Yes yes, can be hard to try, but VERY simple.
Go to your FTP, go to your html/modules folder. Once there, create a folder, for what you
want the link in the menu to be called. 2 Examples: "Test", but if you want spaces, you will
have to do this, "Test_Test". Ok, now, go to your html/text editor on your computer, put
this code in it:

?php      // Add a "<" before ?php

if (!isset($mainfile)) { include("mainfile.php"); }
$index = 0;

include("header.php");

OpenTable2();
// Use the html filename of your chosing below.
include("yourpage.html");

CloseTable2();

include("footer.php");

?>

At Line: 10, where it says "yourpage.html" change that with the html file you will include,
I recommend just using the same name as your folder, i.e, if the folder you created was
named, About, on line 10, put about.html, easiest that way.

Now for the html file, all you have to do, is create a basic HTML file offline, UPLOAD IT
TO YOUR ROOT NUKE DIRECTORY ON YOUR FTP, for example, /html, put the html file in there,
you do not have to make it look like your Nuke site or anything, as the includes in that
php code, added the blocks and whatnot, so you could do a simple code
Save that as yourpage.html, put it in your root Nuke directory, and there you go, you have
to do one more thing though, go to: "http://www.yoursite.com/html/admin.php", click on the
Modules link, find whatever you named it in the list, and click "Activate" on the right,
and it'll be on the menu. See it's easier than people think :)

13) Making Nuke site yoursite.com

Well all you have to do, is create this file, upload it to your root directory for your
website saved as "index.php" and there you go!

?php      // Add a "<" before ?php
header('location: http://www.yoursite.com/html/index.php');
?>

That's it! Save that as index.php and upload it to your root folder in your host.

14) Resource Website's for Nuke

Some helpful resource site's for Theme's, Add-Ons, etc!

http://www.phpnuke.org
http://www.nukedownload.com
http://www.nukeforums.com
http://www.nukestars.com
http://www.nuke-themes.com

There's acouple to get you going.

15) Recommended Programs

Recommended FTP Program: SmartFTP Recommended HTML/Text Editor: Cute HTML

16) Contact Me

AIM SN: el2ik
E-Mail: el2ik@hotmail.com

I'm online almost all the time, so feel free anytime with any problems you're having, or just
want to chat, tell me what you think of this tutorial too! :)--comments-->18--9556--10

phpNUKE tutorial in English

Search from web