Dave PC Guy » PHP and Scripting

Some useful PHP functions

Admin — Fri, 16 Apr 2010 01:10:58 +0000

Recently, I have noticed that I use the same exact functions over and over again in PHP. I’ve actually set-up a complete function list that I tend to include in all of my projects. Here is an overview of some of them.

Let’s connect

You will need to connect to your database from time to time. It is important to do that in most projects that deal with MySQL, and you’ll probably do it frequently, on every page. Now, you can either delete that “function CustomConnect” and the braces and simply include() this part as a file orrr, just add this to your function list and call it up whenever you need it:

function CustomConnect () {

// MySQL variables
$host = 'localhost';
$user = 'username';
$pass = 'password';
$db = 'database';

//connect
global $connection;
$connection = mysql_connect($host, $user, $pass) or die ("Unable to connect!");
//database select
mysql_select_db($db) or die ("Unable to select database!");
}

I have used this function numerous times before and yes, it works. This is the standard MySQL connection. I set up the variable $connection as global so that variable can be used outside of the function. Why do we need that? You will need that for your mysql_close() function where you will use $connection as your argument variable (inside the parentheses). That will, obviously, close the connection to the mysql database.

Change the username, password, and database according to your own website. Tweak the function as needed. I found it bare-boned and just as I need it for my purposes but you can add default variables, make it more of a “function” if you catch my drift.

Let’s Authenticate

Authentication is essential when creating an admin-side for a website. What does it mean? It means that PHP checks if you are, indeed, the logged in user, and if you have permission to see the site. The PHP is rather simple but effective!

function Authenticate () {
session_start();

if (!$_SESSION['auth'] == 1 || isset($_GET['logout'])) {
    // check if authentication was performed
    // else die with error
	session_destroy();
	header("Location: login.php");
}

}

First, we start a session, this tells the server that we are going to use a session. Next, with an “if” loop, we check if the session variable “auth” is set to one, change this however you need to to indicate that a user is logged in. The $_SESSION[''] variable, if you did not know already, stores variable and information between pages. That means that you don’t need to keep using a “post” form to pass the data along. All of it is there in the session, and can be called up whenever.

As you can see, if either the authentication is not set or the $_GET['logout'] variable is set, you will be redirected to login.php. Basically, this is how you log out! You can set up a button or a link to make this work.

This, again, is a bare-boned function. You can add global variables to call on the session variable username or other information.

Let’s Validate

This part is a bit harder.The way I validate is lengthy and redundant, very redundant. Perhaps even wasteful but it works for me and I can sleep soundly because everything is validate correctly. I set up SEVERAL functions to do this:


function isEmailAddress($value) {
        return eregi('^([a-z0-9])+([\.a-z0-9_-])*@([a-z0-9_-])+(\.[a-z0-9_-]+)*\.([a-z]{2,6})$', $value);
    }

function isAlpha($value) {
        return preg_match('/^[a-zA-Z]+$/', $value);
    }
function Alphanum ($value) {
		return preg_match("/^[a-z0-9]+([\\s]{1}[a-z0-9]|[a-z0-9])+$/i", $value);
	}

function name ($var) {
	if (!isAlpha($var)){
	return TRUE;
	}
}

function email ($var) {
	if (!isset($var)){
	return TRUE;
	}
	if (empty($var)){
	return TRUE;
	}
	if (trim($var) == ''){
	return TRUE;
	}
	if (isEmailAddress($var) == 0){
	return TRUE;
	}
}
function message ($var) {
	if (!isset($var)){
	return TRUE;
	}
	if (empty($var)){
	return TRUE;
	}
	if (trim($var) == ''){
	return TRUE;
	}

I told you it was lengthy! All these functions are essential, you may combine some of the “if” statements together with an || or && but I like to keep them separate. As you can see, there are two separate functions above that check for an e-mail address, this is done with pattern recognition. The next function isAlpha does the same but only for alpha characters, Alphanum does the same except that it includes numeric characters. The next three functions (name, email, and message) combine these along with a few “if” statements that check that data has, indeed been submitted via empty($var), trim($var), and other functions already included within PHP. Notice that you will be returned a TRUE value for all of these, meaning that if something is wrong, the result will be true. Use it like this:

if (message($_GET['submittedmessage'])) { echo "Something is wrong";}

And that’s it. If something is wrong, PHP will be echo out “Something is wrong”.

Let’s show some stuff

I like to keep handy one other function that deals with showing the latest entries in a MySQL database. I call it the “ShowComments” function because that is what I originally used it for. You will have to set up this function for each site you’ll use (ie. the rows and stuff like that) but here is what mine generally looks like:

function ShowComments ($var, $where = '') {

$query = "SELECT * FROM database_name $where ORDER BY id DESC";

    // execute query
    $result = mysql_query($query) or die ("Error in query: $query. ".mysql_error());

	if (mysql_num_rows($result) > 0) {
				$x = 1;
		while($row = mysql_fetch_row($result) AND $x <= $var) :
			$link = $_SERVER['PHP_SELF']."?id=".$row[0];
       		echo "To: ".stripslashes($row[1])."";
        	echo "" .stripslashes($row[2])."";
			echo "permalink  ";
			echo substr($row[3], 0, 10)."";
			echo "
			";
			$x++;
		endwhile;
	}
}

I used this function on one of my latest projects (so ignore the id’s). You can add another parameter into the function to change table names on the go but I usually use this for only one table, such as comments, or a feed. I added the $where part so that I can pick out specific rows rather than just all of them at once. Note that you will have to write the entire “where” statement ie. WHERE id=4 not just id=4, okay? Good.

Here’s an example of how I used it:

Notice how I used it two separate times. Once to show the fave latest comments, the second time to show one specific comment with a specific (escaped) id.

Well, this is it. I hope these functions gave you some insight on how you can speed up your work!

Share and Enjoy:

Creating a Blogging System (Part 2)

Admin — Mon, 18 Jan 2010 22:24:36 +0000

Okay, in my first tutorial, you learned about creating an install script for your blog as well as the entry form that will add your blogs.

In this tutorial, I’ll teach you how to parse the data out for your audience and how to edit your entries.

/* LET'S GET STARTED! */

Show off your stuff!

Haha, let’s get into how to show your blog posts to your readers. First, we need some pagination. Search for some scripts or tutorials on google and see if you can find anything. We all like different styles of pagination, and I’m not particularly awesome in custom paginating. If you can’t find anything good, use the code I use, just don’t use the styles, you can create your own.

If you’re using the script I do, or some other one that’s similar, you won’t have any trouble following this tutorial. Actually, you won’t have any trouble doing that anyways. Just make sure that the last MySQL query before the while() loop looks something like this:

$sql = "SELECT * FROM $tbl_name ORDER BY id DESC LIMIT $start, $limit";

The important part of the query that we’re looking for is that “ORDER BY id DESC” part, it tells mysql to place the highest id in the front and the lowest in the back ie. the most recent posts will show at the beginning. The rest is up to the actual pagination script. If it doesn’t use limits, don’t worry about it. If you’re experiencing MySQL errors because of this, place the command elsewhere in the query, it should be close to the table_name selector.

Let’s move onto the while() loop. Every paginating script should ask you for the while loop, so let’s show them what we’ve got:

	while($row = mysql_fetch_row($result)) {
		$content = stripslashes($row[3]);
		echo "$row[1]";
		echo "$row[2]";
		echo ".".$content."";
		echo "
";

	}

Simple enough? Let me explain it. The stuff inside the {} curly braces will repeat WHILE the stuff inside the () is true. Basically as long as there’s data present, what happens inside the curly braces will loop over and over. The insides of () basically mean that we’re storing data in the $row variable that corresponds to the $result from the previous $sql query. The function mysql_fetch_row just fetches the data and in the process puts it in the $row variable.

Do you remember our install script? This is what it looked like for our blog table:

$query = "CREATE TABLE blog
(
id int NOT NULL auto_increment primary key,
title blob NOT NULL,
date blob NOT NULL ,
content text NOT NULL
)";

Now, since in the computer language we start counting with 0 and not 1, it makes things a bit confusing. So column zero is id, column one is title etc. The inside of the while loop tells us to put column one as a title between

tags, column two is the date and goes into

tags, and column three is the content and goes into the
tags.

Now, I’ll assume that in my previous tutorial, you used the function mysql_real_escape_string() for escaping dangerous characters with the “\” backslash. Here’s where a problem arises. If you didn’t use the stripslashes() function you’d end up with something like this (example):

Here\’s the title

18-01-2010

Here\’s the content of the blog. Aren\’t you excited? \:\)

Okay, I don’t really think the smiley would be escaped like that but it could be! I don’t even bother with the rules anymore because it’s a lot easier to get it escaped with the function. The stripslashes() function is the opposite of the mysql_real_escape_string() function because all it does is take out the backslashes so the content looks proper. Remember that! It’s really important because you’ll be escaping A TON of strings!

But that’s it, give it some styling and you’ll have a lovely blog!

Editing your Entries

So, you can write and post blogs. Now what? Well, it’d be nice if you could edit those blogs just in case you made mistake, right?
Well, let’s get on that. First, you’ll need to use the pagination script you used above in the SAME WAY, except with a different while() loop and some html before the loop. You can add this to the previous blog admin page where you added entries to the blog. It’s what I did.

Okay, so add the pagination script and this is what the while loop and the surrounding area looks like:

";
	echo "";
	echo "Id ";
	echo "Title";
	echo "Date";
	echo "Delete";
	echo "Edit";
	echo "";

	while($row = mysql_fetch_row($result)) {
		$id = $row[0];
		echo "";
        echo "$row[0]";
        echo "$row[1]";
        echo "$row[2]";
		echo "Delete";
		echo "Edit";
		echo "";

	}
	echo "";
?>

Alright, what this basically does is create a table with the headings: id, title, date, delete, and edit. To that correspond the correct rows. Notice that I did not use stripslashes() on the entries, why? Because I honestly don’t care. You can use them, but for me, I just need to know the correct blog title, date, etc.

Onto, delete. Notice the URL, you’ll be adding “cmd=delete&id=$id” to your original URL. What that is is basically manually adding GET information. Why do I do it this way? It’s easier than creating a complicated form with hidden values just for a pretty “delete” submit button. Next, you’ll notice that I’m doing the same thing with the GET but this time I am redirecting my page to a separate blogedit.php with the id information.

Let’s see how we can use that delete link first. I’m going to add a script at the beginning of the file that will DELETE this specific entry from the database.

if ($_GET['cmd'] == "delete")
{
	$id = $_GET['id'];
	$sql = "DELETE FROM blog WHERE id=".$id;
    $result = mysql_query($sql);
    echo "Blog ".$id." deleted!";
}

What this says is basically that if the “cmd” $_GET variable is equal to “delete” then execute the loop. Inside the loop I defined the $id variable and used an SQL query that delete the entry. Notice that I did not mysql_real_escape_string() the $id variable. Once again, I am hoping that you know what you’re doing and that you won’t be purposely SQL injecting and messing up your database.

If you want more assurance that this got done (ie. the blog post got delete), you can make a separate if statement inside:

if (isset($result)) {
     echo "Blog ".$id." deleted!";
}
else {
   echo "Blog post: ".$id." not deleted!";
}

Let’s move onto blogedit.php. Don’t forget to include the connection.php file.

This part should be pretty easy. Let’s start with a loop asking if you’re even on the right page (with the right information) and processing the data.

if (isset($_GET['id'])){
		$id = mysql_real_escape_string($_GET['id']);
		$sql = "SELECT * FROM blog WHERE id = '$id'";
		$result = mysql_query($sql) or die ("Error in query: $query. ".mysql_error());
		$row = mysql_fetch_row($result);
		}

This bit takes care of all the information. So yay! We’ve already executed the SQL to get the data and fetched it and stored inside the $row variable. I’ve mysql_real_escape_string() this one, but once again, it’s all up to you as to what you escape and what you don’t.With this done, we can move on to parse out the information in an editable form.

I want to be able to edit the blog the same way I edit in wordpress, or the way I add the blog. I just want the information to show up inside the appropriate fields!

Well, here’s how you do it:

   ID = 
    DATE = 
    
    

    <?php echo stripslashes($row[3]);?>

Okay, first things first. I want the blog ID and Date. Echo it out, done! Next, we’ll create a form with a self action and with the post method (just like in the first tutorial, we don’t want long URLs because of GET requests). Next, we’ll use the same form we did for the blog entry form but, we add the corresponding values. Notice that I used stripslashes() for the content again. You don’t want to get everything double slashed in the end, you’d have to double stripslashes() for your readers. Anyways, i think the rest is self-explanatory. The data will show up in the appropriate fields, you can add it and press “update” to get everything done.

NEXT! The loop that will make ALL of this happen:

if (isset($_POST['update'])) {
		$id = mysql_real_escape_string($_POST['id']);
		$title = mysql_real_escape_string($_POST['title']);
		$content = mysql_real_escape_string($_POST['content']);
		$sql = "UPDATE blog SET title = '$title', content = '$content' WHERE id = '$id'";
		$result = mysql_query($sql) or die ("Error in query: $query. ".mysql_error());

		if ($result) {
			echo "Blog id = $id updated";
		}

}

Yep, whenever you press that pretty “update” button, this will take place. The blog gets update with everything escaped as it should be. And, look! I finally have that $result loop there! It looks like even I learned something from this tutorial

What’s up next?

Well, in my next tutorial. I will FINALLY cover the login system and authorization stuff. It’s pretty easy but I want everyone to digest this info and ask away if you need anything!

STUFF TO REMEMBER

Put include(connection.php); at the beginning of every SQL using file!
The while() loop puts all that data from your database to use!
MySQL columns are marked starting with ZERO, NOT ONE!
Use the stripslashes() function to counteract mysql_real_escape_string() function!
The ?id=23&cmd=edit blah blah stuff is manually inserted GET variable information
Put all of the loops that do the hard work at the BEGINNING of the page!

Share and Enjoy:

Creating a Blogging system (part 1)

Admin — Thu, 14 Jan 2010 02:26:53 +0000

Some time ago (a couple weeks), I created my own blogging system. No one told me how to do it and I didn’t read any tutorials on how to do it either so there were a few things I learned the hard way. As you know, Blogs are database-based, they’re all entries in a table.

You have an entry for the id, date, the content, and miscellaneous other information such as tags, and description. In this tutorial, I’d like to teach you how to do all that.

/* LET'S GET STARTED!*/

Creating The Table

For this tutorial, you’ll have to have your own database, and username. Set up a home server, with WAMP, XAMPP or whatever else. Once you have that done, create that database, I’ll call mine “blog”.

I’m not going to get into how to do that, because if you’re doing this on a server online, you’ll need special instructions. Google it and set it up.

So, let’s create an INSTALL script. Make sure that when you use this script, delete it right after:







This creates an installing button. This is only for convenience. I don’t like scripts that automatically add new tables and such without control.
else {
include ('connection.php');

This little bit will connect you to the database. Here’s what my connection.php looks like:


Great, now you’re in the system (btw, you’ll have to make your own username, password, database, and all that, just like I said you’d have to do. Let’s move on to creating your administration for your site:
//creating a user table
$query = "CREATE TABLE users
(
name varchar(15),
pass varchar(255)
)";

$result = mysql_query($query) or die ("Error in query: $query. ".mysql_error());

//making the user name
$password = md5('password you want to use');
$query="INSERT INTO users (name, pass)
VALUES
('admin', '$password')";

//query
$result = mysql_query($query) or die ("Error in query: $query. ".mysql_error());

Great, now you have a database entry for your user (that’s you!), I won’t get into having multiple users, right now. So bear with me. I’m using a md5 hash to make the password a bit harder to crack. Also, I’m using the usual “admin” for username. Let’s move on to the blog table:
//creating a blog table
 $query = "CREATE TABLE blog
(
id int NOT NULL auto_increment primary key,
title blob NOT NULL,
date blob NOT NULL ,
content text NOT NULL
)";
    // execute query
    $result = mysql_query($query) or die ("Error in query: $query. ".mysql_error());

$query = "INSERT INTO blog (title, date, content) VALUES ('Welcome', 'May 5th', 'First blog entry! Aren\'t you excited?');
";
	// execute query
    $result = mysql_query($query) or die ("Error in query: $query. ".mysql_error());

mysql_close($connection);
echo "Done";

}

With this, we just created a simple blog table that will have a specific id, date, title, and content. We’ve also added a dummy entry (with a date format I won’t be using by the way).

If you’re wondering about the backslash in the word “Aren’t”, don’t wonder anymore. A backslash is used to “escape” characters that may hold a different meaning in the world of programming languages.

For example, if I did not escape that character, I would probably get an error where the MySQL wonders what the “t you excited?” is about since the entry ended at “aren’”.
Before we go on, I would like to seriously address this. The best way to avoid an error is to use a well-known php function mysql_real_escape_string(). This function will automatically add backslashes to all potentially problematic characters. Also, if you use this function, don’t add extra backslashes because the function will escape those as well. There’s only one problem with that function but I’ll show you the solution later on.
Coding the Entry
Now, you’ll notice that while coding the entry, I’m leaving the system open to vulnerabilities, but that’s okay. Why is it okay? Well, unless you’re logged in, you won’t be able to get into the system. So you should be the only one who gets in there and adds entries.
You can screw up your entries by dropping tables and whatnot if you want to, but I’ll assume you won’t be making any crazy MySQL stuff. Also, you’ll have the above-mentioned function to protect you from any unfortunate mistakes.
First add the connection.php file using the include() function. Second, let’s create the form:
Add Blog Post
     
    

    
    

    
    

Place this in the body of your html file, I know it sounds redundant and you should know about this stuff but I’m just making sure. What this form will do is send some information using the “post” method (ie. no URL mumbo jumbo like this: ?dkjw=fsjklwe&fjskl=ewjk) No one wants a three thousand character URL up there (what browser would support that anyways?). You have two separate pieces of information: textarea (where your content goes) and input type=”text” (that’s the title). Anyways, put the next piece of code inside the  tag, or at least above the form.
if (isset($_POST['addpost'])) {
		$title = mysql_real_escape_string($_POST['title']);
		$content = mysql_real_escape_string($_POST['content']);
		$date = mysql_real_escape_string(date('m-d-Y'));
		$sql = "INSERT INTO blog (title, date, content) VALUES ('$title', '$date', '$content')";
		$result = mysql_query($sql) or die ("Error in query: $query. ".mysql_error());

		if ($result) {
			echo "Blog id = ".$id." updated";
		}

}

Well, that’s some good stuff. The submit button in the form sent the post variable name “addpost” with the value “Add Post!”. The loop above goes into motion right when that post variable is submitted. I escaped all the strings just in case. Oh, if you didn’t know, you can use html, css, and all that other stuff in your posts. It won’t screw up anything, I promise  
Anyways, you can see I used a date function to specify the date the blog was submitted. Read up more about it if you want to use a different time stamp. This one looks like this “1-13-2010″. We then added all the values we needed into the database. And voila, we just added our first entry!
What’s next?
In my next tutorial, I’ll show you how to correctly show all that data! I’ll also get into how to protect your administration sites and how to create the login site too.
STUFF TO REMEMBER

MySQL uses a lot of special characters. To avoid an error use the mysql_real_escape_string() which will sanitize your entries to some extent. There’s one small problem with the function, but I’ll address that in the next tutorial
Use the include() function for your connection.php file for each site that connects to the MySQL database. It’s easier than rewriting the code numerous times (especially if you decide to change the user name and all that)
Delete the install.php installation script after you’re done. You don’t want anyone messing with your scripts. It also creates a vulnerability if you leave it on the server. If you think you’ll forget, get on PHPmyAdmin and do all the querying manually.
HAVE FUN!





Share and Enjoy:

Mobile Websites (tips)

Admin — Mon, 11 Jan 2010 23:28:37 +0000

I’ve recently started working on some mobile websites. You’ll notice that davepcguy.com has its own mobile alternative as do some other sites. Mobile devices are growing in number and gone are those days when internet was viewed only on the computer screen. WAP is not even used either so that old school coding is gone too.

These days, almost everyone has an iPhone or a BlackBerry, or a Palm device. Some of us even have other devices like PSPs, tablets, and others that require quite a bit different formatting. Here’s how to go about making your mobile website.

Step 1 – The Vision

First, you gotta have a vision of what you want. The best way to get a good vision is by picking up your phone and browsing the internet, looking through some popular websites such as youtube, flickr, facebook, myspace, and other sites that you know get a lot of traffic and are likely to have their own mobile version.

I recently saw a really nice blog post detailing some of the nicer mobile sites. The theme there is common:

Everything is single column. There are no side-bars, there are no fancy tabs. Everything is in a single column. Think of it as a letter. There are no columns in a letter, you have a header, the body, and the footer.

Header: Generally, you’ll use the header of the page to announce the website’s name and to show menu links. You may also place a commercial in this area (Google Adsense uses commercials). Here’s what I used on my Only A Quote mobile site: It’s a simple banner that effectively tells the user what’s going on.
Body: This is pretty self-explanatory, you put the meet of your site here. Try to use well organized information. Don’t just slap stuff there. Mobile users are more likely to leave your site than regular computer users. Also, keep the graphics swift! Not too much.
Footer: Use the footer for copyright info and other blah blah stuff but don’t over do it! I know huge footers are fashionable but not for mobile users!

Keep it all simple!

Step 2 – Design

Here are a few tools that will help you with your design:

Keep in mind that different phones will render your page differently so try to make it as simple as possible. To catch the widest possible audience, focus on the big three: iPhones, BlackBerries, and Palm phones. Samsung and Nokias are common too, especially outside of the US but BBs and iPhones capture most of the market. Android is coming up too, so watch out for them too.

A few simple rules:

Keep the site less then 400px wide.
Cross-browsing is a bitch on Computers, it’s worse on phones, render for Safari and Opera Mobile
Graphics should not exceed 20kbs
Keep the layout basic

There are tons more rules but those are the basics.

Step 3 – Coding

First of all, DON’T USE JAVASCRIPT! It works on a lot of phones, it’s gaining support, but it’s really bothersome (I know, I use my phone to browse the net a lot). There’s no need for it. Hover and other pretty stuff is useless too. Many phones don’t support it.

Use as little mark-up code as you can. If your original site has thirty divs, make it three in this one. There’s no need for all that on phones. If your CSS screws up, so will your divs.

Use the following doctype:

This will tell the browser that it’s meant for phones. It’ll help rendering and it’s the RIGHT thing to do haha. Once you start coding, again, keep in mind that your website should be the smallest possible.

Here are a couple of rules to keep in mind:

Don’t use px/em sizes, do everything in percentages, you never know what kind of a phone the user will use.
Keep all files as small as possible.
If your .PNG graphics do not use transparency, convert them to JPGs with smaller quality
If you use .PNG graphics WITH transparency, consider remaking them into JPGs or GIFs (for transparency) if at all possible
Keep all graphics less than 400px wide. I suggest 350px tops.
Use “ALT” for images, some phones may not render the text and it’s standard .mobi rule
Try not to use tables or javascript
Don’t use external resources (ie pictures from other sites, scripts from other sites, etc)
Define sizes for images with the width = “” and height = “” html tags
NO POP UPS!

That’s about it.

Step 4 – Testing

You’ll need to test your site, so use the resources mentioned in the emulator part. Use your phone as well!

Here’s another resource that will catch ALL of your mistakes:

Ready.mobi

This site checks your markup, the size of your site, and many other features. It will tell you if you did something wrong and will usually tell you what you can fix on your site. It also features five different phone emulators on the spot. It also ranks the speed of your site. Here are my stats:

Oh yeah, that’s a bad rating. It’s mostly because of all the graphics on my site, the CSS involved and inter-linking on my blog. It happens but it does pretty well on my BlackBerry so try to look at your rating positively especially after you do your own tests. As you can see, it tells you the different speeds with GPRS, 3G, and Wi-fi.

Step 5 – Implementation

Let me save you a few hours of searching. In implementation, you’ll have to figure out how exactly you’re going to redirect your traffic to the mobile version whence they use their phones. It took some time for me to figure out but here are a few options:

DetectMobileBrowsers – This is almost a fullproof method of redirecting your traffic. The problem? You can’t use it unless your site is COMPLETELY non-profit. Nope, not even ads are allowed. If you want the commercial version, it will cost you $50 a year to use it
LightWeight Device Detection – This is probably one of the simplest scripts you’ll find and it works really well. It also doesn’t have any restrictions as far as I’m aware.
Mobile Detect – This is a slightly more functional version of the above-mentioned Device Detection. They’re not related but work in a similar way

Let’s move on to actually using these scripts. I haven’t used number one but I’ll tell you how you can incorporate number 2 and 3.

Decide whether you want a separate site for the mobile version. I recommend creating a sub-domain such as m.onlyaquote.com (whence using sub-domains, remember that m.onlyaquote.com = onlyaquote.com/m )
If you did not create a separate sub-domain, you can place the whole thing in a loop but don’t forget to create a backdoor so that the user can switch between the desktop and mobile version.
Put all the script messy stuff into a separate file (so as not to clutter up your index.php file) except for the if/else statement found in number 2. If you’re using number 3, don’t worry about that at all.
Use include(script file ); to put the script back into your index.php file. Put all of your PHP before the tag

If you’re using Number 2, here’s what you do:

include ('scriptfile.php');
if($mobile_browser>0) {
   // do something
header( 'Location: mobilesite.com' ) ;
}

If you’re not using a different site do this:

include('scriptfile.php');
if($mobile_browser>0) {
 // place your mobile site here.
}
else {
   // place your desktop version here
}

You can also simply switch out CSS files with this method (make sure to put the loop inside the tag then). I don’t suggest you use the default CSS method of switching styling according to the device (ie. ) because it doesn’t work that well and most devices will try to read BOTH stylesheets.

For number 3, again place the following loop before the tag:

include("Mobile_Detect.php");
$detect = new Mobile_Detect();
if ($detect->isMobile()) {
    // any mobile platform
header( 'Location: mobilesite.com' ) ;
}

With the number 3 method (ie. Mobile Detect) you can also specify which mobile device you want to do what. You can choose a separate site for an iPhone and Blackberry or separate CSS files. Well, whatever, you can do it all.

CAUTION: The detection system is NOT perfect. With newer phones, newer browsers, and newer software, the detection script may become obsolete. Be always on the look out for better versions!

Conclusion

That’s it, with these few tricks, you should be able to easily make your own mobile site. Here’s what mine looks like (I still have a TON of work to do!):

Share and Enjoy:

Bit.ly API and adding URLs to your MySQL database

Admin — Mon, 21 Dec 2009 22:16:10 +0000

In my last tutorial, I’ve touched on how to use the to.ly API and how to make automatic “Tweet it” buttons with a relevant message.
Well, this can get problematic if with every page refresh, your server sends out a request to the to.ly server for a short link. Pretty soon, you’ll be getting “Too Many Connections” and you’re screwed. Just like I was, so here’s an idea. How about we store those links in a database….automatically?

You see, it’s much easier to create a script that will request a shortlink, adds the link to the database, and then just call it up whenever you need it. It works perfectly well on my quote site. Basically, whenever you create a website with get-requests, tons of pages, and all that. You can use the following script to make it all work, automatically (again).

Bit.ly shortlink implementation
Adding URL Links to a MySQL database

Bit.ly

Let’s get some bit.ly action going here. First, you need to create an account. Then you need to get the bit.ly API key Next, let’s look at a neat script I found and made a few changes to so you could simply use include() and have a ready function with all the right variables:

// Variables
$bitlylogin = 'loginname';
$apikey = 'long series of numbers that make up your API key';

/* make a URL small */
function make_bitly_url($url,$login,$appkey,$format = 'xml',$version = '2.0.1')
{
 //create the URL
 $bitly = 'http://api.bit.ly/shorten?version='.$version.'&longUrl='.urlencode($url).'&login='.$login.'&apiKey='.$appkey.'&format='.$format;

 //get the url
 //could also use cURL here
 $response = file_get_contents($bitly);

 //parse depending on desired format
 if(strtolower($format) == 'json')
 {
 $json = @json_decode($response,true);
 return $json['results'][$url]['shortUrl'];
 }
 else //xml
 {
 $xml = simplexml_load_string($response);
 return 'http://bit.ly/'.$xml->results->nodeKeyVal->hash;
 }
}

I like to set my function up like this so that I can always interchange values, and so that I will automatically have the right values stored in those two variables above ($bitlylogin and $apikey). You don’t need to do that. You could simply change the function definition like to include defaults:

function make_bitly_url($url,$login = 'loginusername',$appkey = 'long api key',$format = 'xml',$version = '2.0.1')

Now as far as implementation of the script goes, it’s pretty simple:

$url = "Http://www.davepcguy.com";
$shorturl = make_bitly_url($url, $bitlylogin, $apikey);
echo $shorturl;

And you’ll get the short url echoed out. If you use the default value version you can simply do this:

$url = "http://www.davepcguy.com";
$shorturl = make_ibtly_url($url);
echo $shorturl;

You’re done. Easy enough, eh?

MySQL Database

Believe it, or not. It’s actually rather tricky to add a URL into a database. You have to select the correct format in the table, decode and encode stuff. It’s pretty messy and I have not found a good tutorial online on how to do this.
So here goes, let’s assume you use the method above to create short links. It’ll make life much easier, trust me.

First, let’s create a table in your database:

//login variables
$host = 'localhost';
$user = 'username';
$pass = 'password';
$db = 'sample database';

//connect
$connection = mysql_connect($host, $user, $pass) or die ('Unable to connect!');

//database select
mysql_select_db($db) or die ('Unable to select database!');

//the right query
$query = "CREATE TABLE sample_table
(
id int NOT NULL auto_increment primary key,
name varchar(50) NOT NULL,
email varchar(50) NOT NULL ,
message text NOT NULL,
url varchar(255) NOT NULL
)";

//executing query
$result = mysql_query($query) or die ('Error in Query');

Notice that I used a varchar(255) for the datatype. You could use varchar(55) or any other number. Every shortlink by bit.ly is 20 characters…max. The problem is when you add the information in your database so I recommend a good 255 characters.

Next, you have to make sure you know what you want out of the script. I made a script so that every time my website asked for a row of information, it would automatically add the URL (since I was a bit late with this idea, I had to find a way to add the information without having to recreate the whole database). Also, it’s a good practice to check if the data is present and in case it’s not, add it. Here’s what I did:

//connect

$name = 'sample name';

//query for a particular row with the name
$query = 'SELECT * FROM sample_table WHERE name = $name'';

    // execute query
    $result = mysql_query($query) or die ("Error in query: $query.".mysql_error());

//check if the url column has anything in it
if (empty($row[4])) {

//if it IS empty, let's make a shortlink
$url = make_bitly_url($permalink,$bitlylogin,$apikey,'xml');
//we have to encode the url. I'll explain that
$url = urlencode($url);
//make a query to update (don't forget the quotation marks!)
$query = 'UPDATE quotes SET url = "'.$url.'" WHERE name = '.$name.'';
//execute query
$urlresult = mysql_query($query) or die ("Error in query: $query. ".mysql_error());
//decode url for later use in the script
$url = urldecode($url);
}

//let's make an else statement in case the information IS present
else {
//let's decode that encoded url
$url = urldecode($row[4]);
}

Now you have the $url variable down! w00t. You can do a bunch of stuff with that. Like implement it in that twitter button I keep talking about. Check out my new site too to see it in action.

Oh about that encoding and decoding. If you try to submit the $url without encoding it, you’ll get an error because the characters “/” and “:” and some of the other ones have a special meaning in SQL. Here’s what the encoded and decoded versions look like:

normal: http://bit.ly/8oQBvB

encoded: http%3A%2F%2Fbit.ly%2F8oQBvB

decoded: http://bit.ly/8oQBvB

As you can see, the encoded version uses the “%” characters (ascii) for the coding.

Don’t forget to encode and decode then!

I hope you enjoyed my tutorial
Share and Enjoy:

“Tweet This” and URL shortening API

Admin — Sat, 19 Dec 2009 23:00:26 +0000

Alright, you’ve all seen those CRAZY “Tweet This” buttons on so many websites, (mainly wordpress). You may have also noticed that some just send you to twitter and you have to manually input the twitter message. Well, how about we just make a button that will automate all this for us?

I really do love it when I click on that button and twitter pops up with a pre-written message like “Check out this site : URL GOES HERE” or “Crazy CSS tutorial on backgrounds. Check it out: URL GOES HERE”, it makes it much easier for me to share my finds. Here’s a great demo.

Okay, I’m working on a new website and it has various posts on it that I want the readers to be able to automatically share on twitter. I also want to include a backlink so that their twitter followers can visit the actual article. Basically, here’s a tutorial on shortening URLs using API and for creating a twitter button.

URL shortening

As you may know, there are tons of URL shortening services. Most, including bit.ly and tinyurl.com support API services which basically means, you can use PHP (and AJAX) in order to use their services on another server. That’s BASICALLY what it means. I’m not a master of this. Bit.ly requires an account so I won’t be getting into that. I don’t want my account to be spammed with a ton of different links. But, if you want to keep track of how many people clicked and posted your link, you are more than welcome to read a tutorial on it elsewhere.

I’m not too big on tinyurl.com anymore because it requires way too many characters. And for twitter use, it’s basically useless so I browsed around and found to.ly which has really basic API info already posted. Let me copy it real quick:

function CompressURL($url) {

  $ch = curl_init();

  curl_setopt($ch, CURLOPT_URL, "http://to.ly/api.php?longurl=".urlencode($url));
  curl_setopt($ch, CURLOPT_RETURNTRANSFER,1);
  curl_setopt($ch, CURLOPT_HEADER, 0);

  $shorturl = curl_exec ($ch);
  curl_close ($ch);

  return $shorturl;

}

Add this function to your function.php, if you use an external function list (use require() to add it to your site), or just add this function in your header on your site so that whenever you call upon it later, it will be at your disposal. Now, let’s get the URL of the site you’re on. Let’s say you have a dynamic page and don’t feel like manually writing each separate link. We can use the $_SERVER variable for that. A combination actually:

echo "http://".$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF'].$_SERVER['QUERY_STRING'];

This will echo out the whole URL, including any GET statements you may have entered. If you don’t want those statements, erase the last $_SERVER variable. Okay, so let’s put it all together to shorten the link using the previous function:

$permalink = "http://".$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF'].$_SERVER['QUERY_STRING'];
$url = CompressURL ("$permalink");

Now that we have the compressed URL, let’s move on to the tweet button.

Tweet This Button!

Well, go out and find some great twitter icon. Or make your own. It’s easy. You go into photoshop and make a 150 x 50 px rectangle and write twitter in it. That’s not what this tutorial is about.
Twitter has an easy-to-use API (Is it even API?).

http://twitter.com/home?status= MESSAGE GOES HERE

So there goes the message. Very easy, no? Now, here lies the problem. What kind of message do you want? You could use different functions and variables that describe each page on your site. If you set them manually (in the META tag), use this instead so that the description is already stored for later use. In my newest site, I used the actual content of the page (a quote) for the message:

$description = "An article about php scripting and creating a simple tweet this button.";
echo $description

Twitter has a character limit of one forty, right? We can take care of that too. “substr()” is a function that will allow you to cut up your description. It works like this: substr($string, begin cut, end cut). I use a 100 character cut off:


$twittermsg = substr($description, 0, 100);

$twittermsg .= "...more on".$url;

The message is complete. A hundred character message ending with “…more on URL”. Finally, the button and link:

The “onmouseover” and “onmouseout” are used for a nice hover effect (onmouseover will be the hoveved, and onmouseout is the non-hovered). Using CSS would be a literal pain because you’d have to create a clickable div or a span…display none. Well, just trust me, this is MUCH easier.

I hope you enjoyed this short tutorial!

Check out my next tutorial for bit.ly API!

Share and Enjoy:

Custom E-mail Form

Admin — Thu, 15 Oct 2009 19:14:43 +0000

AH! So I have to create a custom e-mail sending form. He wants me to create a webform that will ask for a person’s name and e-mail address. Once those are input, an e-mail will be sent to the person’s e-mail account with a thank you message. Meanwhile, the website will reload with a custom coupon that bears their name. I’ll need it printable so I’ll have to add a print button as well.
Sounds simple enough, right?.. right?

First off, go create a coupon. After you’re done with that, we can start working. Make sure the “name” field is left out though, we’ll add that in later with some CSS. Originally, I wanted to send the coupon in the e-mail, forcing the customer to input the right e-mail address but I realized that most e-mail clients do not support CSS and especially not the “position: absolute;” property and value.

Tip: I update the script periodically, and have numerous times while writing this tutorial. None of the scripts mentioned in this post are necessarily WRONG but at the bottom of the page is the current “release” that I’ve created. The images may not correspond directly with the code they represent.

Setup

Alright, here’s what you’ll need to do. You need to download MIME (MultiplePurpose Internet Mail Extensions), which is an e-mail extension for php that allows you to send HTML e-mails. If your site operates under c-panel, like mine is, then just scroll down, find the PHP extension icon. Search for “MIME” and install the packages. If you need to install them manually, search through google “Installing MIME on” your OS. I cannot really help you out more than that because I am not an expert on PHP extensions. There are multiple guides online though that WILL help you out.

installing MIME

Press Install

Once you press install, the package will automatically install. It may ask if it can install other dependent packages, simply OK it.

Basic Form

Modified Mail Form

Let’s start scripting. I advise you to create a mail.php form that you can “include ()” or “require()” into your existing website. It’s much neater this way and the PHP won’t get in the way of your layout. Here’s the basic form I created for our purposes:


Name:
 

E-mail address:
 

Message (optional):

I used the “$_SERVER['PHP_SELF']” variable for the action so that we won’t have to create yet another script page to use the information. The “name” field will translate to $_POST['name'], the”e-mail address” into $_POST['email'], and the optional “message” into $_POST['optmessage']. There is nothing much more to it. I used maxlength for the name 41 characters because my full fictional name, “Captain Soren William Alexander Janus VI.”, is exactly 41 characters long . 40 characters for the e-mail seems sufficient enough as well. 140 character message is the same as twitter’s max tweet. There is nothing much else to this.

Are you feeling “Loopy”?

Let’s move on. We need to create a loop that will ensure our data has been entered and that we are not dealing with a blank form. The purpose of this basic loop is to show the initial form for the user to submit the data to, reload the form if any errors were made during submission (ie invalid entries), and send the email in the end.



Form goes here



Something entered was wrong, please re-enter your information:
form goes here.

Confused? Don’t be. The beginning tells us if the form has been previously submitted, if not, the form will load. The second part after “elseif” checks if all the data entered is correct. After all the conditions have been met, we progress to the last “else” which will execute the mail sending.

“Validate This!”

If you look above, you’ll see a strange function called “isEmailAddress”. I set this function up using a script I found. Here is the function:

function isEmailAddress($value) {
        return eregi('^([a-z0-9])+([\.a-z0-9_-])*@([a-z0-9_-])+(\.[a-z0-9_-]+)*\.([a-z]{2,6})$', $value);
    }

It basically checks if the e-mail is in the correct format. It also makes sure that only a single e-mail address has been entered and that it does not contain any malicious code.

Tip: If you wish to add database support to this script, you’ll have to use a validation function for the name and message as well!

Next part of validation are the “empty()” and “trim()” functions. “Empty()” is self-explanatory. You entered the variable name and the function will check if it is empty or not. If it is, the function returns TRUE. “Trim()” works similarly except here it takes out all the extra spaces and such. If it equals ‘ ‘ or an empty space, then it will return TRUE. The “elseif” statement is setup so that it checks the e-mail and name value.

Tip: If you have some time on your hand you can create a function that will check for each of these statements like: function CheckValue ($var) { if (empty($var) {return TRUE;} if (trim($var) == ‘ ‘) { return TRUE;} }

Second Form

Incorrect entry

You have a choice here. Under “elseif ()”, you can create new “if” statements and inform the user of what exactly is wrong. For example if the name is empty, you can create an if statement like this:

if (empty($_POST['name'] || trim($_POST['name']) == ' ') { ?>
 echo "You left the name field empty";

I like to keep the user in the shadows and put all of the validation together using the || which means “or” and the same original form will show up with the message “Error: Please enter a valid e-mail address and your name”. Add the following form under “elseif()” between the php tags:

Error: Please enter a valid e-mail address and your name


Name:
 

E-mail address:
 

Message (optional):

It’s the same form with a little message on top.

Everything “Else”

So all the variables go through, the script is validated. What now then? Now we’ll send the e-mail and refresh the site. I am using e-mails for a good reason. Whenever a user asks for a coupon, I’ll have a copy of their name and their e-mail address for future reference. I COULD use a database system but I’m a lazy person. I’ll point you in the right direction if you wish to do that though. Instead, let’s focus on what I already have done.

We should set up our variables first, writing out $_POST['email'] is quite a hassle. Plus, we have to set up the e-mail variables as well. Also note that this is in the last else {} section:

//variables

$to = $_POST['email'];
$subject = "Coupon from the Chiropractors";
$name = $_POST['name'];
$optmessage= $_POST['optmessage'];
$opt = wordwrap ($optmessage, 70);

The mail function works like this:

mail (to, subject, message, headers)

So we set up the “$to” variable which we will direct to the e-mail. We’ve also set up the subject of the e-mail and put $_POST['name'] into the $name variable for later use. Next, I transferred the optional message into $optmessage variable which I then word-wrapped into $opt. You have to word-wrap your e-mail message and the longest line can only have 70 characters. Using the “wordwrap ()” function and the parameter “70″, we’ve accomplished that. Let’s write the message:

$message = " Chiropractic

Dear $name,
Thank you for visiting us at ourWebsite.

Please print out your coupon and present it on your next visit. Thank you, and we hope to see you soon!

Sincerely, Alexander

optional message:
$opt

Your e-mail: $to

Note that e-mail clients have different support of HTML and CSS. Don’t include any XHTML, that’s way too complicated. This is the reason why I did not put the coupon into the e-mail. Most e-mail clients do not support the “position: absolute”. Alright, let’s setup our header variable. With headers, you can define who the e-mail is from, where to reply to the e-mail, send different copies, and most importantly, use MIME.

 //header information
$from = "no-reply@davepcguy.com";
$headers = "From: $from" . "\r\n";
$headers .= 'MIME-Version: 1.5.2' . "\r\n";
$headers .= 'Content-type: text/html; charset=iso-8859-1' . "\r\n";
$headers .= "BCC: reply@davepcguy.com" . "\r\n";

I used an e-mail address I set up through c-panel. Set it up the same way you set up any other e-mail account. And you won’t even have to include the password in your script. Let’s break down the header.

The first header establishes from where the e-mail will be sent. Always break the lines when setting up the header variable using “\r\n”. Next, set up your MIME and its version. The newest one should be 1.5.2 but check your version under the PHP addons/modules in your c-panel. If you can’t make it work, use “MIME-Version: 1.0″. Next, set the content-type. Just copy the above, there should be no other alternative. The script will also send a BCC (Blind Carbon Copy) of every e-mail to my own e-mail address so that I can keep records. Let’s send it then!

//functions
$mail_sent= mail("$to", $subject, $message, $headers);

All that work and it’s summed up in one single line, amazing, eh?

The Script After

Hmm…I think I should give the user the coupon finally, don’t you think? They’ve done SO much work. Well, let me set up the message then:

//announcement $sent= "

Dear $name,
Thank you for visiting us at Website Here is your coupon

$name

Please print this coupon out and present it on your next visit. Thank you, and we hope to see you soon!

Sincerely, Alexander

P.S. please print out your coupon immediately or save this page because it will not be available after you close out. If you're having any trouble, please contact our webmaster.

Optional Message:
$opt

"; echo $mail_sent ? $sent : "Mail failed"; echo $sent; } ?>

Haha, I know, it looks complicated, doesn’t it? Well not really, the “$sent” just sets up a variable with the html code I plan to use in my webpage. Beware, you’ll have to adjust this according to your own webpage. the echo $mail_sent ? $sent: “Mail failed”; is a short hand for an if loop ” if ($mail_sent) {$sent} else { “Mail Failed”};” then the $sent variable will echo out.

final page

Extras

database support
print
extra validation

This is how I finished out my script. I don’t plan on doing too much to it other than making it printable. I’m thinking about making a pop-up window that will display all of that information. Let’s review some of the extras you can add.

Database Support First, you can add database support. Simply make a new database in MySQL (using PHPmyAdmin) and set up two columns, one for name, and the other for name. Set up the table or use this SQL command if you can, creating the database might be tricky, but you should be able to use the “CREATE TABLE” part. If you can’t, just set it up manually using the values shown:

CREATE DATABASE coupondb;

CREATE TABLE `coupons` (
    `id` int(11) NOT NULL auto_increment,
    `name` varchar(255) NOT NULL default '',
    `email` varchar(255) NOT NULL default '',
    PRIMARY KEY  (`id`)
) TYPE=MyISAM;

You can probably make a third column for an order (1., 2., 3.) or for the date and time. Add this at the beginning of the “else{}” :

//MySQL variable
$host = "localhost";
$user = "user";
$pass = "password";
$db = "coupondb";

//connect
$connection = mysql_connect($host, $user, $pass) or die ("Unable to connect!");

// select database
mysql_select_db($db) or die ("Unable to select database!");

First, set up the host variable ie, where the database is. I’ll trust my WordPress senses and leave that with localhost. You’ll have to create a new username and password as well as a database manually using c-panel or a different site manager your hosting provides you. Input the user and password. Change the “die” variable to something like “internal server error” or something, this is just for educational purposes. I got it off Zend Dev Zone again. Make sure you put this BEFORE the e-mail sending (ie the mail() function) because it’s senseless to send the e-mail but not make a database entry. Here’s the basic query:

 // create query
    $query = "INSERT INTO coupons (name, email) VALUES ('$name', '$to')";

    // execute query
    $result = mysql_query($query) or die ("Error in query: $query. ".mysql_error());

    // close connection
    mysql_close($connection);

And there you go, database support added. Check out my full script on the bottom for the full implementation with the duplicate entries check as well as other features.

Print Let’s check out how to print all this stuff out. I found a neat piece of JavaScript that can accomplish this. It’s a bit tricky and I still can’t get it to show the best results but, it seems to work well nonetheless. You can find it here. Add the header part into the real header where you’ll use this mail.php script. Then, modify the $sent variable:

$sent= "

 Dear $name,

Thank you for visiting us at Website
Here is your coupon

 $name 

 Please print this coupon out and present it on your next visit. Thank you, and we hope to see you soon!
 Sincerely, Alexander 
 P.S. please print out your coupon immediately or save this page because it will not be available after you close out.
If you're having any trouble, please contact our webmaster. 
Optional Message: 

$opt

   
";

Change the width to suit your needs. And I am completely aware there is a million different divs just in this script (you should see the pages I code, million more divs) but they are mostly mandatory. You can switch the “div” around the “$name” variable to . You’ll have to spend some time adjusting this, the width of the page, the margin, as well as the different positions to suit your needs. It worked for me almost perfectly

Extra Validation Okay, so if you want to use a database with this form, you’ll need some extra validation as a precaution against SQL injection. We’ve already validated the e-mail address and I won’t be validating the optional message just yet. So let’s validate the name. I used a function from the same script I cited when I used the e-mail validation function:

// check whether input is alphabetic
    function isAlpha($value) {
        return preg_match('/^[a-zA-Z]+$/', $value);
    }

Add this function to the beginning of the document and add another || to the elseif () {} part of the loop saying “!isAlpha($_POST['name'])”. Also, warn the user that they can use only letters for the name and no periods or other characters nor numbers. The optional message SHOULD be validated but I am not certain how to go about it just yet. I’d like to let the user be able to use some personalized html code so I won’t look into it too much. Also, I am not storing that message so I don’t have to fear an SQL attack.

Conclusion

I hope this shed some light on how you’d create an e-mail form as well as how to use the mail() function. As you can see, the possibilities with PHP are endless. I’d like to also inform you that it took me several hours to write this script with numerous trial&error runs. I’m self-taught, and mostly used the PHP manual as a reference. I hope this helped and that you have fun trying this out for yourselves!

I’d appreciate any comments regarding the security of this script as well as usability. I, myself, am about to launch the script on one of my pages so I’d like to know what people have to say about it.

Final Script with all its features added: Note that I will update this part of the post as necessary when I find bugs and optimize it.



Please enter your name and e-mail address. The name field supports only alphabetic characters (letters).

Name:
 

E-mail address:
 

Message (optional):
 




";
 }
 if (email($_POST['email'])){
 echo "Please enter a valid e-mail address in this format: account@email.com. 
";}
?>


Name:
 

E-mail address:
 

Message (optional):
 



 

 Dear $name,

Thank you for visiting us at Website
Here is your coupon

 $name 

 Please print this coupon out and present it on your next visit. Thank you, and we hope to see you soon!
 Sincerely, Alexander 
 P.S. please print out your coupon immediately or save this page because it will not be available after you close out.
If you're having any trouble, please contact our webmaster. 
Optional Message: 

$opt

   
";

//MYSQL QUERY
//check for duplicates
$duplicate = mysql_query("SELECT * FROM coupons where email='$to'");
$affected_rows = mysql_num_rows($duplicate);
if($affected_rows >= 1)
{
echo $sent;
echo "Note: If you have already entered your e-mail address before, you will not get another e-mail message. 

This is to prevent spamming.";
die('');
}
else {
// create query
 $query = "INSERT INTO coupons (name, email) VALUES ('$name', '$to')";

 // execute query
 $result = mysql_query($query) or die ("Error in query: $query. ".mysql_error());

 // close connection
 mysql_close($connection);

}

//html message
$message = "


Chiropractic



 Dear $name,

Thank you for visiting us at ourWebsite
 Please print out your coupon and present it on your next visit. Thank you, and we hope to see you soon!
 Sincerely, Alexander 
optional message:

$opt

Your e-mail: $to 

";

 //header information
$from = "no-reply@davepcguy.com";
$headers = "From: $from" . "\r\n";
$headers .= 'MIME-Version: 1.5.2' . "\r\n";
$headers .= 'Content-type: text/html; charset=iso-8859-1' . "\r\n";
$headers .= "BCC: reply@davepcguy.com" . "\r\n";

//functions
$mail_sent= mail("$to", $subject, $message, $headers);

//announcement

echo $mail_sent ? $sent : "Mail failed";
echo $sent;
}

?>

Share and Enjoy:

Setting up (Part 1)

Admin — Tue, 15 Sep 2009 22:12:24 +0000

Here’s the first part of my “Setting Up” tutorials. It will teach you how to set up to learn PHP, and for web development. It is my own personally journey as well because I’m getting ready to make new WordPress themes. I’m using Windows XP, soon will be upgrading to Windows 7 (when it comes out) so most of my tutorials will be Windows-oriented.

Installing the Server Software

The best way to learn PHP and scripting is at home and without buying a domain nor paying for hosting. So let’s set up your computer as a server using XAMPP. XAMPP stands for X (as in a variable instead of an OS name) Apache, MySQL, PHP, and PERL. You can use any other alternative depending on your operating system. There’s also WAMP for Windows (I use this one) and MAMP for Mac. All are basically the same with small differences. I’ll show you how to use XAMPP because it’s the most cross-platform package. I’ll do an article on how to set up your Linux with XAMPP later.

So what are these packages? They install the Apache Server, MySQL database system, and PHP all in one. The packages are all set-up to interact and will save you a ton of time. You won’t have to install each program separately and try to intertwine them. It will all be done for you. Go to the XAMPP website, select Windows and download the newest package available. Don’t get distracted by the add-ons.

Depending on the package that you downloaded, you’ll either have an executable file or an archive (zip). I downloaded the .exe for my windows because it was forty megs lighter and easier to set-up. Let’s move on. If you downloaded the .exe file, open it and install it in a folder. When choosing a destination folder, I recommend using your main drive (usually C:\) and a subfolder. I’m installing my XAMPP package into C:\server\, click install, follow the directions and you’re done. If you used the .zip download, extract all of the contents into a folder (C:\server\ for me) and follow the read me which tells you to use a couple .bat files to set-up everything. Once you’re done, start up the XAMPP Control Panel (it will be under start>programs>Xampp for Windows> Xampp Control Panel). If you’re having problems with the Control Panel, start the MySQL and Apache services by double-clicking on apache_start.bat and mysql_start.bat in the main folder.

Here’s what the control panel looks like, it will list a different Windows version etc. but that’s alright:

You can start up all the services shown by just clicking on start. I had some problem with it so I used the .bat files instead. Now point your web browser to http://127.0.0.1/ and you’ll see a XAMPP splash page, pick the language and let’s get going. I’ll cover all the features of XAMPP later tutorials, so for now, be happy that it works

Keep your browser there and read on. Put all your PHP files and other files in …/xampp/htdocs/yourfoldername/ I set mine up /xampp/htdocs/learningPHP and I put an index.php file in there that will link me to all my scripts and tutorials that I absolved (ie. tutorial one). This will keep your folders organized and it’ll be easier to find these files. Type in http://127.0.0.1/learningPHP and you’ll get to your index.php file there. Unlike WAMP, XAMPP doesn’t seem to have a listing directory on its server but don’t worry too much about that. We’re set-up and ready to go. If you didn’t get any of this, don’t worry about it. Just remember to make a new folder in /htdocs/ where you can store your php scripts and other stuff. Also, remember that unless you set up your apache and mysql as services (the process is in the readme file and included in the .exe installation), you’ll have to start them every time you start up your computer.
To get rid of XAMPP, simply delete the folder or use the provided “uninstall_xampp.bat” file

Setting up the Database

While in your browser is at http://127.0.0.1/xampp/ Click on PHPmyadmin and follow these directions.

click on the “privileges” tab
add a new user
type in your user name, I’ll use the user name “Alexander”
under the host tab, click “local” and it’ll fill out localhost in the field next to it
type in a password, I’ll use “davepcguy”
Database for user: none
check all privileges (it’s the easiest and as long as you don’t put your server online, it’ll be safe)
click “Go”
go back to “Databases”
under Create New Database, create one, I created “WP” for my WordPress

Now I have a database named “WP” under the username “Alexander” with the password “davepcguy”

Your database list should look like this:

The first five databases are preset, and my “wp” database is the one I made.

Setting up WordPress:

First, go download WordPress.

then:

extract the zip file into htdocs
change “wp-config-sample.php” to “wp-config.php”
open the file with your PHP editor. You can also use your text editor if you don’t have a PHP editor yet. I’ll post a short tutorial on setting up your PHP editor later.

find this section:

 // ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define('DB_NAME', 'putyourdbnamehere');

/** MySQL database username */
define('DB_USER', 'usernamehere');

/** MySQL database password */
define('DB_PASSWORD', 'yourpasswordhere');

/** MySQL hostname */
define('DB_HOST', 'localhost');

/** Database Charset to use in creating database tables. */
define('DB_CHARSET', 'utf8');

Change “putyourdbnamehere” to the database name you created, in my case it would be “wp”
Change “usernamehere” to the username we set up earlier, in my case that would be “Alexander”
Change “yourpasswordhere” to your password we set earlier, in my case it would be “davepcguy”

save the file and your result should look like this:

// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define('DB_NAME', 'wp');

/** MySQL database username */
define('DB_USER', 'Alexander');

/** MySQL database password */
define('DB_PASSWORD', 'davepcguy');

/** MySQL hostname */
define('DB_HOST', 'localhost');

go to: http://127.0.0.1/wordpress

Now let’s install WordPress. Type in the blog title and your e-mail. Press “install”. It will give you a randomly generated password. Copy that password and click “Log in”. Type “Admin” as user name and paste the password. Viola, you got your own home WordPress blog set up!

A couple of tips:

go change your password immediately, there should be a link on top of the page to do that
your wordpress password and your MySQL password are NOT the same
you can always change your e-mail and password under Users>your profile
before you start posting blog-posts, change your nickname from “admin” to something else
to log in next time, go back to “http://127.0.0.1/wordpress” and find the login button at the bottom of the right sidebar

That’s all you need to start messing around with PHP and WordPress for now. Have fun figuring out WordPress, I’ll have a tutorial ready later to explain how to use its functions fully but you probably won’t need that. Also, note that this set-up is for home use only. I’d suggest a better username and password if you were to host your blog online. Setting up a WordPress blog online is a bit different, there is no “phpmyadmin” and you’ll have to create a database differently, and probably using software your host provides. Enjoy!

http://127.0.0.1/wordpressgo

Share and Enjoy:

A PHP poem

Admin — Thu, 10 Sep 2009 15:43:25 +0000

We all know PHP is a lot of fun in on itself but let’s put some basic skills into making a creative script. Something, you probably wouldn’t even consider doing because it seems like a waste of time. Don’t laugh, I know what you’re thinking. And I know that you’ll laugh when you finish reading this article.

So how about we write a PHP poem. Yeah, you think it’s silly, but so what? I found that making useless fun code is the best way to learn, at least for a beginner. It helps getting used to setting up the variables, doing switches, and making sense of forms. I wrote this piece of code when I started out with PHP a couple months ago. Now let’s start!

First, set up the variables. I decided to make my poem a bit “dynamic” (or rather interactive) so I used some different feelings that the user can choose from:

$happiness = "happy, and joyful about your life";
$sadness = "sad, and just plain down";
$loneliness = "lonely because no one is around";
$togetherness = "companionship because you love your friends";
$love = "love, pure love.";
$depression = "depressed, because that happens sometimes, too";

Haha, excuse my poor code-to-wordpress integration skills, it seems that google syntax highlighting hates me. I’ll fix it later when I find a good plugin.
Anyways, here we go, I set up a few basic variables describing emotions that I want to use in my script. These are all classified as strings for those of you who don’t know.
Now let’s put them in an array:

$feelings= array( $love, $depression, $sadness, $happiness, $loneliness, $togetherness);

This will make it easier to echo out. Next, I’ll set an “if” statement to check if anything was submitted to the $_POST global variable. This variable is generally used when submitting form data, intrigued about what I’m going to do next?

if (!isset($_POST['submit'])){
Are you feeling:


$feel
";
 }
?>

The “if (!isset($_POST['submit']))” piece of code is probably the most fundamental and amazing part of PHP. As you can see above, the code will be self-sustaining, it will not need another external file. The “if” statement makes sure there are no $_POST values submitted and when they’re not, it echoes out a form which will THEN submit a value to $_POST. I know, it’s ingenious.

Let’s move on though, what does the form above say? Let’s translate it to plain English because this is the most important part of the script:

If there are no values submitted to the $_POST variable,

write “Are you feeling:”

then, show a form that will submit its information to “PHP_SELF”, which is the site itself, using the “POST” method.

next, for every variable in the $feelings array, show the value of the variables and show a checkbox that will send data to the “whatifeel[]” array(the data will be stored in $_POST['whatifeel'].

Finally, show a button that will submit all of the information to the server.

Let’s move onto the action, getting the work actually done. The next part of this code will feature the “else” code as well as the final result after you submit the data into the server.


 and how you feel, 

and what is real
";
 switch ($f) {

 case $happiness:
 echo "And when you envision yourself

in love, with money and wealth

you'll feel happy.

";
 break;
 case $loneliness:
 echo "
And when you remember him or her, 

he or she does not prefer 

your company nor you.

";
 break;
 case $sadness;
 echo "
And when you think that person or event

the memory of sight and scent

you remember your sadness.

";
 break;
 case $togetherness;
 echo "
And when you look around and see 

you and your present company

you'll be glad to be.

";
 break;
 case $love;
 echo "
And when you see that one,

she will become, 

and represent your love.

";
 break;
 case $depression;
 echo "
And when you feel on the inside

and you know you've tried

you feel sad and depressed.

";
 break;
 }

 }

}?>

There we go. Now let me explain the mechanics of this: First, I closed the “if” tag and introduced the “else”. Next, I used “foreach” to echo out the first stanza of the poem (I’ll tell you what is happening…). This stanza will repeat for every variable submitted into $_POST['whatifeel']. The second stanza depends on the variables submitted so I made a switch. This switch will echo out the next stanza depending on what variable it’s dealing with. If you submitted the value “$sadness”, it will echo out “And when you think….” as the second stanza. The process will repeat for every single value you submitted in the first part of this process. I added the “

” and “

Here’s what the first part of the script looks like when parsed:

And after you select the feelings, here’s your poem:

Try it out for yourself! I uploaded the script. I’ll have a download version for you in a couple of days! I hope you enjoyed my rather simple and fun tutorial.

The point of these simple tutorials is to teach you the basics and how to apply them to do something fun. I don’t think you’ll ever use this exact script anywhere (and if you do, you better give me credit! ) but you’ll use parts of it like the !isset($_POST['submit']) and the forms, and the switch too of course. It’s easier to learn PHP if you apply to something you already know and what’s fun for you. I like writing so this presented an opportunity for me to express my writing in an experimental form. Try it out!

PHP error reporting script

Admin — Sat, 05 Sep 2009 15:42:41 +0000

We’ve all encountered errors, especially during the synthesis of a new code. This is what a typical error looks like when you run it at a server at home:

Parse error: parse error in C:\directory\10_3.php on line 4

Here, we know that the error was a parse error and that it happened in a file called 10_3.php and it was on line 4. A parse error is typically just a missing semi-colon or a bracket. Nothing major, but it still triggers a fatal error. You can read all about the different errors and how to deal with them in the PHP manual or at this nifty Zend tutorial. I learned most of my PHP skills from that tutorial so read through it because it will definitely help you out.

Now, if you have your own webpage set up, you certainly don’t want the users to see all that stuff, right? They won’t understand what it means and it’s not a nice way to show an error anyways.

There are numerous ways to deal with error. You can use the try catch method to eliminate and deal with errors. I’m not fluent in that method so I won’t even try to explain it. One way to deal with non-fatal errors is adding this to your PHP script:

error_reporting(E_ERROR);

This will only trigger errors that are fatal to the system. You can add “~” in front of the “E_ERROR” inside the parenthesis and PHP will not trigger any fatal errors but it will all the others. If you want extra errors to report, such as if a number is negative instead of positive, or whatever else. Use this piece of script:

function isnumbernegative ($num) {

if ($num < 0 ) {

trigger_error (“Number is negative”, E_USER_ERROR);

}

}

This script will always trigger a user error. You can change the “E_USER_ERROR” to “E_USER_WARNING” which will let the script go on but will still display the error. Now let’s move on to something more complicated. I wrote a simple error-reporting script that will greatly help you out. It’s a simple text-based error-logging system using the function set_error_handler:

set_error_handler(‘error’);

function error($type, $msg, $file, $line, $context) {
echo “
Error!
”;

$date = date(‘l jS \of F Y h:i:s A’);

echo “Here is the information provided by the script:”;

echo “
”;

 //shows the error code

 echo “Error code: $type
”;
//error message

echo “Error message: $msg
”;
//error in what file and what line

echo “Script name and line number of error: $file:$line
”;

$variable_state = array_pop($context);

echo “Variable state when error occurred: “;

print_r($variable_state);

echo “
”;

//logging the error
$dir = ‘…/text_files/errors.txt ‘ or die (‘Could not be found’);
$open = fopen($dir,‘a’) or die (‘Could not be opened’);

fwrite($open, “ERROR: $date
type: $type,
msg: $msg,
file: $file,
line: $line,
context: $context

“

) or die (‘Could not be written’);

die (‘Error has been logged
’);

}

Next enclose the script in “” and save it. The original script that I based this one on did not have the text file logging capability. A few pointers: replace the “…/text_files/errors.txt” with a full directory name. You also have to create your own “errors.txt” file and if you don’t delete the entries at least once in a while, you’ll end up with a very large file over time. You can include a simple “if” loop and the function “file_exists()” to deal with the file creation. The next step is to implement the script into your website. You can use “include(‘script.php’)” or use “require(‘script.php’)” any one of these. I suggest you make a separate folder for scripts. The error will show up like this:

Error!

Here is the information provided by the script:

Error code: 2
Error message: Wrong parameter count for explode()
Script name and line number of error: C:\directory\12.php:17
Variable state when error occurred: string

The errors.txt will apear slightly differently but will include the same data plus time and date. Anyways, that’s it. Thank you for reading, and I hope you enjoyed this rather simple tutorial on error reporting.

Share and Enjoy: