News:

Want to get involved in developing SMF, then why not lend a hand on our github!

Main Menu

SMF Documentation Help Squad

Started by Jade Elizabeth, November 19, 2008, 12:01:42 AM

Previous topic - Next topic

Acans

Bloke, Shelia, Shout, Ute, Stubby's

All invented by great Australians
"The Book of Arantor, 17:3-5
  And I said unto him, thy database query shalt always be sent by the messenger of $smcFunc
  And $smcFunc shall protect you against injections and evil
  And so it came to pass that mysql_query was declared deprecated and even though he says he is not
  dead yet, the time was soon to come to pass when mysql_query shall be gone and no more

Jade Elizabeth

Quote from: antechinus on January 21, 2009, 10:17:18 AM
Where's your manic patriotism? Australian is a real language. Stone the crows, cobber, do you have any idea what you're implying?

Lol okay Ant, if you can make me laugh like an idiot by translating this install document to Aussie, I'll consider letting someone do it:

Quote from: Jade on September 06, 2005, 04:33:22 PM
Installing an SMF forum has never been easier! Installing SMF can be done in five fast and simple steps:



1. Download the Install Archive

The latest SMF release can be found on the downloads page of the official Simple Machines website.

Download the latest version of SMF from the official Simple Machines website. Commonly, .zip files are the preferred download type. Most operating systems have the tools available to extract .zip archives already installed. See Download File Types for more information.


2. Extract and Upload the Install Archive

Once the install archive has been downloaded it will need to be uploaded and extracted before the installer can be run. There are two possible methods for this step. The method used will depend on the tools available with the control panel supplied by the hosting service provided.

SMF can be uploaded to the site root, or to a directory on the site, such as www.yourdomain.com/forum.

Uploading Before Extracting
Some control panels have the ability to extract an archive, such as cPanel. This allows for hassle free uploading and extraction of the archive. Once the archive is uploaded, select the extract option to extract the archive to the desired location.

Extracting Before Uploading
If extracting abilities are not available inside the control panel, the archive can be extracted before uploading. Generally right clicking the archive and selecting the extract all option will work. The directory structure should be retained when the install archived is extracted, so all files and directories are in the correct places.


3. Set File Permissions

After the install archive has been uploaded and extracted, the files need to have their permissions set. This is commonly called CHMOD. The correct CHMOD for SMF files is either 777, 775 or 755, depending on the hosting service provided. There are two methods for this step, the method used depends on the hosting service provided. For more information on CHMOD, see how do I use CHMOD? / what is CHMOD?.

Setting File Permissions With the Installer
The SMF installer can set file permissions simply and easily. Navigating to the directory where SMF resides, should redirect to the install.php file and prompt the installer. For eg: www.yourdomain.com/forum/install.php. If the installer detects files that need their permissions adjusted it will prompt for FTP details so it can CHMOD the files it requires for the install. This may not work on some servers.

Setting File Permissions With FTP
Using a control panel or FTP client, file permissions can be changed quickly and easily. Usually, FTP programs will allow permissions to be changed by right clicking files/directories and selecting properties, attributes or permissions. The desired numerical value can be entered, or if provided, check boxes can be changed. For more information on FTP, see how do I use FTP? / what is FTP?

The Following files and directories should have CHMOD values of 777, 775 or 755:

  • /attachments
  • /avatars
  • /Packages
  • /Packages/installed.list
  • /Smileys
  • /Themes
  • /Themes/default/languages/Install.english.php
  • agreement.txt
  • Settings.php
  • Settings_bak.php
  • install.php


4. Create a Database and a Database User

Before running the installer, a database and a database user will need to be created. A database will store all of the information a forum requires, such as members, posts, and topics. A database user will allow the forum to access the stored information. The information for the database and the database user should be remembered for use with the installer.

Creating a Database Using phpMyAdmin
Most shared hosting services disable this option. If the option to create databases through phpMyAdmin is available through the hosting service provided, the database can be created from the phpMyAdmin home page.

Creating a Database Using a Control Panel
Shared hosting services usually disable the ability to create a database through phpMyAdmin. If the hosting service provides a control panel interface, this can be used to create a database. Selecting the MySQL Databases or Database Wizard option should take you to prompts for creating a MySQL database. With different hosts these options may have different names.

SMF 2.0 has the ability to support other database schemas, including PostgreSQL and SQLite. SMF 1.1 supports only MySQL database schemas.

Creating a Database User
database user can be created through the control panel provided by the hosting service. Selecting the MySQL Databases or database Wizard option should take you to prompts for creating a MySQL database user. With different hosts these options may have different names. These options may change if a different database schema is used for SMF.

The database user requires the following permissions, however, more can be granted: SELECT, INSERT, UPDATE, DELETE, ALTER, and INDEX.


5. Run the Installer

<img src="images/install11.gif" align="right" title="SMF 1.1 Install Screen"  alt="SMF 1.1 Install Screen" border="0" style="margin: 10px;" />
The final step in installing SMF is running the installer. The information from the previous steps will be used in the installation process.

The SMF install screen looks different for SMF 2.0 and SMF 1.1, however, both still require the same information. Navigating to the directory where SMF resides, should redirect to the install.php file and prompt the installer to run. For eg: www.yourdomain.com/forum/install.php.

Basic Forum Settings

  • Forum Name – The name for the forum being installed should go here. By default this is set to "My Community". This can be changed later via the server settings section of the administration center if needed.
  • Forum URL – The URL the forum can be found at, without the trailing slash. The SMF installer will most likely have this correct, so it is safe to leave this field alone.
  • Gzip Output – If Gzip output tests pass, this can be used to save bandwidth and make pages load faster.
  • Database Sessions – Sessions can be stored in the database, or in files. Database sessions are more reliable, secure, and may work better on sites with multiple servers.
  • UTF-8 Character Set – UTF-8 character sets are useful for international forums, or forums that use languages other than English.
  • Allow Stat Collection – This option allows Simple Machines to collect statistics from your forum, anonymously, so the software can grow to meet the needs of its user base. For more information on statistic collection, please see the statistics collection information page.

Database Server Settings

  • Database type – The database schema can be selected here from a list of database schemas supported by the server being used. Newer schemas (for SMF 2.0) such as PostgreSQL and SQLite may be listed here if available. MySQL and PostgreSQL are recommended.
  • Server name – The location of the database is specified here. 99% of the time this will be localhost.
  • Username – The username used for the database user should be placed here. If help is required for this, the hosting service provider should be contacted.
  • Password - The password for the database user is entered here.
  • Database name – The name used for the database should be placed here. If help is required for this, the hosting service provider should be contacted.
  • Database prefix – The prefix for all tables associated with this install is specified here. Prefixing tables with unique prefixes enables more than one application, or SMF install, to use the same database safely.

Creating an Administrator Account
The SMF installer will ask for information to create the forums administrator account. This information includes username, password, and email, just like a regular account. Once created, this account can be used to visit the administration center to manage and configure the forum.

Finishing the Installation Process
Once all parts of the install have completed, check the box to remove the install files from the server. If this does not work they will need to be deleted via FTP. All installer files should be removed from the server once the installation process is complete as they are a major security risk if left on a server unattended. Once SMF is installed they are no longer needed.

Congratulations on installing SMF successfully!! Simple Machines hopes you enjoy using SMF! If you require support, you may ask for it on the community or search the Online Manual for help.


Installation Errors

Sometimes the installer runs into an error when installing. Most errors are documented in the installation questions FAQ section.

If the error encountered is not documented, the install and upgrade help board on the community can assist in fixing the error.

It might have errors, there's a new linking system by "keyword" that we're testing, so I had to remove that code from it :P
Good luck :P

Quote from: α¢αηѕ on January 21, 2009, 10:14:33 AM
This is coming from an Australian

also are you using the school computers

We have phrases sure. I've been considering an SMF translation for a while to Aussie....but I havent gotten around to it.
Once proud Documentation Writer and Help Squad Leader | Check out my new adult coloring career: Color With Jade/Patreon.

Antechinus

Quote from: α¢αηѕ on January 21, 2009, 10:18:54 AM
Bloke, Shelia, Shout, Ute, Stubby's

All invented by great Australians
Bloody oath, digger. That sheila was trying to lump us in with the Pommies and Septics.


Quote from: The Traitorous WenchLol okay Ant, if you can make me laugh like an idiot by translating this install document to Aussie, I'll consider letting someone do it:
Be careful what you ask for. :D

Acans

Do you wanna split the work ant, I'll take the first half.
"The Book of Arantor, 17:3-5
  And I said unto him, thy database query shalt always be sent by the messenger of $smcFunc
  And $smcFunc shall protect you against injections and evil
  And so it came to pass that mysql_query was declared deprecated and even though he says he is not
  dead yet, the time was soon to come to pass when mysql_query shall be gone and no more

Jade Elizabeth

Once proud Documentation Writer and Help Squad Leader | Check out my new adult coloring career: Color With Jade/Patreon.

Acans

"The Book of Arantor, 17:3-5
  And I said unto him, thy database query shalt always be sent by the messenger of $smcFunc
  And $smcFunc shall protect you against injections and evil
  And so it came to pass that mysql_query was declared deprecated and even though he says he is not
  dead yet, the time was soon to come to pass when mysql_query shall be gone and no more

Antechinus

Quote from: α¢αηѕ on January 21, 2009, 10:57:30 AM
Do you wanna split the work ant, I'll take the first half.
We should scull a dozen tinnies each and then do alternate sentences without cross checking.

Acans

Quote from: antechinus on January 21, 2009, 11:02:01 AM
Quote from: α¢αηѕ on January 21, 2009, 10:57:30 AM
Do you wanna split the work ant, I'll take the first half.
We should scull a dozen tinnies each and then do alternate sentences without cross checking.

well i've or ready taken a ganda at that one above so i'll just finish it.
"The Book of Arantor, 17:3-5
  And I said unto him, thy database query shalt always be sent by the messenger of $smcFunc
  And $smcFunc shall protect you against injections and evil
  And so it came to pass that mysql_query was declared deprecated and even though he says he is not
  dead yet, the time was soon to come to pass when mysql_query shall be gone and no more

Acans

Quote from: Acans Australian Translation
Installing an SMF forum is easier than throwing snages on the barby! You can do it in 5 easy steps mate.



1. Download the Install doobie

The latest SMF release can be found by taking a ganda at the SMF website.

Flog the latest version of SMF from the official Simple Machines website. usually, .zip files are the preferred flogging type. Most porn boxes have the tools available to open the .zip archives already installed. Take a ganda at the Download File Types for more information.


2. Open and put the Install doobie

Once the install doobie has been you need to put and open so you can install it mate. There are two ways to lay these bricks.

thats what i've done up to
"The Book of Arantor, 17:3-5
  And I said unto him, thy database query shalt always be sent by the messenger of $smcFunc
  And $smcFunc shall protect you against injections and evil
  And so it came to pass that mysql_query was declared deprecated and even though he says he is not
  dead yet, the time was soon to come to pass when mysql_query shall be gone and no more

Antechinus

Good start, but a little too formal for my taste. :D

Acans

Quote from: antechinus on January 21, 2009, 11:21:08 AM
Good start, but a little too formal for my taste. :D

you wanna edit just that bit so i can see what you mean
"The Book of Arantor, 17:3-5
  And I said unto him, thy database query shalt always be sent by the messenger of $smcFunc
  And $smcFunc shall protect you against injections and evil
  And so it came to pass that mysql_query was declared deprecated and even though he says he is not
  dead yet, the time was soon to come to pass when mysql_query shall be gone and no more

Antechinus


Acans

family site doesnt apply to my PM box
"The Book of Arantor, 17:3-5
  And I said unto him, thy database query shalt always be sent by the messenger of $smcFunc
  And $smcFunc shall protect you against injections and evil
  And so it came to pass that mysql_query was declared deprecated and even though he says he is not
  dead yet, the time was soon to come to pass when mysql_query shall be gone and no more

Antechinus

In that case I have something you may enjoy. Hang on.

Acans

Quote from: antechinus on January 21, 2009, 11:32:27 AM
In that case I have something you may enjoy. Hang on.

kk, i got it, lets move this convo to our Pm's and away from jades doc help squad topic
"The Book of Arantor, 17:3-5
  And I said unto him, thy database query shalt always be sent by the messenger of $smcFunc
  And $smcFunc shall protect you against injections and evil
  And so it came to pass that mysql_query was declared deprecated and even though he says he is not
  dead yet, the time was soon to come to pass when mysql_query shall be gone and no more

Jade Elizabeth

Quote from: α¢αηѕ on January 21, 2009, 11:30:44 AM
family site doesnt apply to my PM box

LMFAO I want a copy.

No, leave the conversation here, I believe it to be on topic ;)
Once proud Documentation Writer and Help Squad Leader | Check out my new adult coloring career: Color With Jade/Patreon.

Acans

"The Book of Arantor, 17:3-5
  And I said unto him, thy database query shalt always be sent by the messenger of $smcFunc
  And $smcFunc shall protect you against injections and evil
  And so it came to pass that mysql_query was declared deprecated and even though he says he is not
  dead yet, the time was soon to come to pass when mysql_query shall be gone and no more

Antechinus


Jade Elizabeth

Once proud Documentation Writer and Help Squad Leader | Check out my new adult coloring career: Color With Jade/Patreon.

Advertisement: