Drupal 6 Social Networking Build a social or community web site with friends lists, groups, custom user profiles, and much more Michael Peacock BIRMINGHAM - MUMBAI This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Drupal 6 Social Networking Copyright © 2009 Packt Publishing All rights reserved. No part of this book may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, without the prior written permission of the publisher, except in the case of brief quotations embedded in critical articles or reviews. Every effort has been made in the preparation of this book to ensure the accuracy of the information presented. However, the information contained in this book is sold without warranty, either express or implied. Neither the author, Packt Publishing, nor its dealers or distributors will be held liable for any damages caused or alleged to be caused directly or indirectly by this book. Packt Publishing has endeavored to provide trademark information about all the companies and products mentioned in this book by the appropriate use of capitals. However, Packt Publishing cannot guarantee the accuracy of this information. First published: February 2009 Production Reference: 1170209 Published by Packt Publishing Ltd. 32 Lincoln Road Olton Birmingham, B27 6PA, UK. ISBN 978-1-847196-10-1 www.packtpub.com Cover Image by Vinayak Chittar (vinayak.chittar@gmail.com) This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Credits Author Michael Peacock Reviewers Alan Doucette Ashok Modi Dan Kurtz David Kent Norman Josh McCormack Senior Acquisition Editor Douglas Paterson Development Editor Swapna V. Verlekar Technical Editor Shadab Khan Copy Editor Sumathi Sridhar Editorial Team Leader Akshara Aware Project Manager Abhijeet Deobhakta Project Coordinator Leena Purkait Indexer Monica Ajmera Hemangini Bari Proofreader Camille Guy Production Coordinator Shantanu Zagade Cover Work Shantanu Zagade This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 About the Author Michael Peacock (http://www.michaelpeacock.co.uk) is a web developer from Newcastle, UK with a degree in Software Engineering from the University of Durham. After meeting his business partner whilst studying at Durham, he co-founded Peacock Carter (http://www.peacockcarter.co.uk), a Newcastle based creative consultancy specializing in web design, web development, and corporate identity. Michael loves working on web-related projects, and when he isn't working on client projects he is often tinkering with a web app of his own invention, his latest app is Learnr (http://www.learnr.co.uk). He has been involved with a number of books, having written three books: Drupal Social Networks, Selling Online with Drupal e-Commerce, Building Web Stes with TYPO3, and acted as technical reviewer for Mobile Web Development and Drupal Education & E-Learning. You can follow Michael on Twitter: www.twitter.com/michaelpeacock This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 I'd like to thank everybody at Packt Publishing, in particular: Douglas Paterson for the idea of this book, and for working with me on structuring the book; Leena Purkait for helping to keep the book on track; Swapna Verlekar, the development editor; and Shadab Khan, the technical editor; and of course the technical reviewers, Josh McCormack, David Kent Norman, Ashok Modi, Dan Kurtz, and Alan Doucette, who helped improve the quality of the book. My thanks also go to my friends and family, in particular my fiancée Emma for her support while working on the book, my Grandfather Neil for continually checking on the progress of my latest book, and my business partner Richard for keeping the business running smoothly during times when I was too busy writing about web sites to make them. Finally, I'd like to thank you, the reader; I hope that you enjoy this book, and produce a fantasic social networking web site of your own. I look forward to hearing your feedback and seeing what social networking sites you come up with! This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 About the Reviewers Ashok Modi is a talented web application programmer who has worked for both large and small tech companies in Toronto and the United States. Ashok works in Java, PHP, C/ C++/Objective C, SQL and Ruby on Rails. He holds an Honours B.Sc. in computer science from the University of Toronto where he specialized in Software Engineering. Alan Doucette is a partner of KOI (koitech.net), a web development company. He is passionate about PHP and open source software. He is also very active in the web community and a contributor of Drupal. His constantly changing blog is kept at http://alanio.net. Thanks go to the awesome Drupal community for all their daily hard work creating great open source software. I would also like to thank my business partner, Ben Davis, for his support and dealing with a Drupal fanatic. Dan Kurtz is an Internet Strategist and Lead Developer at Trellon LLC, a web development company specializing in open-source social media and content management. Since 2006, he has produced dozens of Drupal sites, helped plan a series of DrupalCamp unconferences, and created the Teleport module for system administrators. When he's not focused on Drupal, he is usually acting in plays or hunched over a sewing machine. Dan has a BA in Cognitive Science from the University of California, Berkeley and a Master's of Information Studies from University of Toronto. He currently lives in Oakland, California, and maintains an online headquarters at http://brickswithoutclay.com. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 David Kent Norman has pursued a lifetime of quality education and expertise in technology. His various career pursuits in the past eight years have focused on web-based content management and Drupal. He holds a Bachelor's degree in business, Master's degree in Management Information Systems and a Ph.D. in Instructional Technology. He published and managed a Content Management System (CMS) with developers from around the world. His CMS was used as the basis for PHP-Nuke and other related projects with more than 8 million downloads. Since he left managing his own CMS project, he has been heavily involved with the Drupal CMS. Today, David is one of few permanent members of the Drupal Association's General Assembly, a distinction only granted by an election process of peers. In his time with Drupal, David has written or contributed to over 75 modules and themes now freely available for download from Drupal.org. Since 2006, he has been a mentor for the Google Summer of Code program, which brings in new talent to Drupal every year. He was also a reviewer of Learning Drupal 6. Josh McCormack is the owner of InteractiveQA, a social network development company. InteractiveQA uses Drupal to create highly interactive sites that engage visitors to come often, stick around, and generate content. Past and present clients include SonyBMG, Audobon, AsiaSociety.org, Petstyle.com, and others. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Table of Contents Preface 1 Chapter 1: Drupal and Social Networking 7 Social networking 7 Why create a social network instead of joining an existing one? 9 Improve business 10 Enable communication 10 Provide a service 10 So why create a social network? 11 DinoSpace! 11 What is a CMS? 11 What is Drupal? 13 Drupal as a social networking platform 13 Installing Drupal 14 Requirements 14 Download 15 Installation 15 Configuring Drupal 21 Actions 22 Administration theme 23 Clean URLs 23 Date and time 24 Error reporting 24 File system 25 Image toolkit 26 Input formats 27 Logging and alerts 29 Performance 30 Site information 31 Site maintenance 32 Summary 33 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Table of Contents [ ii ] Chapter 2: Preparing Drupal for a Social Networking Site 35 How Drupal works 35 An abstract framework 35 Nodes 36 Content flags 37 Collaboration 38 Terminology 39 Administering Drupal: an overview 39 Logging in 39 User management 41 Access rules 41 Permissions 42 Roles 43 User settings 44 Users 45 Content management 46 Comments 46 Content 47 Content Types 49 Post settings 50 RSS publishing 50 Taxonomy 52 Site building 52 Blocks 53 Menus 55 Modules 58 Themes 59 Site configuration 59 Reports 60 Recent log entries 60 Top 'access denied' errors 60 Top 'page not found' errors 60 Available updates 60 Status report final 61 Planning our site 61 Static content 62 Grouping content 62 Starting to build our site 63 Taxonomy! 63 Creating the vocabulary 63 Creating terms and tags for our vocabulary 65 Creating another vocabulary—free tags 66 Creating content 66 Summary 69 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Table of Contents [ iii ] Chapter 3: User Content: Contributions, Forums, and Blogs 71 Our site 72 User roles: an important note 72 Drupal modules 73 Comments 74 Comments within Dino Space 76 Forums 76 Planning 76 Creating and managing forums 77 Creating a forum topic 80 Taxonomies 81 Planning: How will roles fit in? 83 Blogs 83 Blog menu 84 Viewing blogs 84 Using the blog 85 Blog API 85 Posting a blog entry from Microsoft Word 86 Collaborative writing 86 Creating a book 87 Creating pages in the book 88 Permissions and roles 89 Why not grant all permissions? 89 Polls 89 Roles 92 Contributions in the form of pages 92 Permissions and roles 92 Uploaded files/attachments 92 Automatically generated content 94 Feed aggregator menu 97 Viewing the feed in action 98 Cron 98 Social aggregation 99 Download the module 99 Install and enable the module 99 Configure the module 100 Using the module 103 Roles 105 Anonymous role permissions 105 Authenticated users 105 Creating the additional roles 106 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Table of Contents [ iv ] Contributors 106 Moderators 106 Power contributors 106 Summary 107 Chapter 4: Users and Profiles 109 What are we going to do and why? 109 Install the modules 111 Users, roles, and permissions 112 Users 112 Viewing/searching/sorting/filtering 113 Creating a user 114 Editing 115 Roles 117 Permissions 117 Adding special properties to user profiles 118 Module overview 119 Extending our users' profiles 119 Single-line text fields 122 Multi-line text fields 123 Date field 123 List selection field 124 Free form list field 124 Web address field 125 Editing our profile 125 About you 126 About your dinosaur 126 Tracking user activity 127 Settings and rules 128 Access rules 128 Blocking email domains 128 Preventing swear words in our user's usernames 129 Checking rules 129 User settings 130 User registration settings 130 User email settings 131 Picture settings 132 Blog themes 135 Enabling themes 135 Using the blog themes module 135 Expanding on this feature 136 Open ID 136 User already exists 137 User does not exist 137 Summary 138 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Table of Contents [ ] Chapter 5: Enabling User Interaction 139 Dino Space: a review 139 Installing the modules 139 Relationships 141 Planning 141 Creating our relationships 142 Settings 145 General settings 145 Email notifications 146 Elaborations 146 Messages 146 Permissions 147 Relationships in action 148 Default relationship 148 Creating a relationship with another user 148 My relationships 150 User activities 151 Permissions 151 Activities in action 151 Public list 152 Friends list 152 Settings 153 Profile comments with the Guestbook module 155 Settings 155 Permissions 158 Site-wide guestbook 159 User guestbooks 160 Viewing guestbooks 160 Contacting users 162 User contact forms 162 Site-wide contact form 163 Creating the contact form categories 164 Adding information to the top of the form 167 Enabling the contact form in the menu 167 Taking the content form for a spin 168 Groups 169 Groups for Dino Space 169 Organic Groups module 169 Create group content type 170 Configure page content type 171 Enabling the block 171 Creating a group 172 Summary 174 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Table of Contents [ vi ] Chapter 6: Communicating with our Users 175 Getting started 175 The modules 175 A look back 176 Modules 176 Communicating on an individual basis 176 Inactive users 176 Communicating with individuals publicly 177 Mailing lists 177 How to send an email to all our users? 179 HTML emails 180 Legalities 180 Throttling 180 Third-Party Services 181 PHPList 181 Constant contact 181 Google Groups 182 Direct contact 182 The address module 182 Users perspective 182 Administrators perspective 183 Content blocks 183 Creating a content block for anonymous users 184 Theme customizations for communication 185 Summary 185 Chapter 7: Improving our Network with Custom Modules 187 Our module 187 Drupal's modular system 188 A module 188 Useful resources 188 Creating our module 189 Content types 189 New content types 189 Google Maps 192 API key and the JavaScript files 192 Template files 193 node-map.tpl.php 193 node-venue.php 194 Module files 195 Directories and locations 195 .info files 196 .module files 196 .install files 207 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Table of Contents [ vii ] Putting everything together 210 Installing the modules 210 Creating a map 211 Adding a venue 212 Seeing the module in action 212 Useful APIs 213 GMap 213 Facebook 214 Summary 214 Chapter 8: Designing our Site 215 Drupal themes 215 Themes and our users 216 Pre-installed themes 217 Bluemarine 217 Chameleon 218 Garland 218 Marvin 219 Minnelli 219 Pushbutton 220 Contributed themes 220 Installing contributed themes 220 Customizing the default theme 221 Color scheme 221 Custom color sets 222 Color set preview 222 Toggle display 223 Logo image design 224 Shortcut icon settings 224 Global settings 225 Creating a theme: The basics 225 Theme structure 226 Info file 226 Template files 227 Template.php 227 Logo and screenshot 227 Other files for themes 227 Getting started 228 Info file 233 Template files 234 Template.php 238 Logo and screenshot 239 In action 239 Summary 240 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Table of Contents [ viii ] Chapter 9: Deploying and Maintaining our Social Networking Site 241 Installing the modules 241 Security 242 Security announcements 242 Securing our site 243 CAPTCHA 243 Mollom 248 Legal 250 Passwords 251 Deploying 251 Hosting and domain names 252 Getting the site online 253 Setting up the database 253 Uploading the site 256 Changing the database settings 258 Maintenance 258 Cron 258 Performing maintenance 259 Upgrading Drupal 260 Reports 260 How can these help? 261 Backing up 261 Backing up with cPanel 262 Restoring 262 Restoring within cPanel 263 Summary 263 Chapter 10: Promoting our Site 265 Online advertising 265 Buying advertisement space 266 Pay Per Click Advertisements 266 Advertisement networks provided by search engines 267 Newsletter advertising 268 Caution: Search Engine Penalization 268 Newsletters 269 Marketing materials 269 Social marketing 270 Viral marketing 270 Twitter 270 Social bookmarking 271 Search Engine Optimization 271 On-site SEO 271 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Table of Contents [ ix ] Meta 272 Sitemap and webmaster tools 272 Links 272 Up-to-date content 272 Off-site SEO 273 Monetizing your site 273 Summary 273 Appendix: Installing WAMP 275 Installing WampServer 275 Downloading WampServer 275 Installing WampServer 276 WampServer overview 279 Configuring WampServer 280 GD2 280 Rewrite Module 281 Summary 282 Index 283 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Preface This book uses Drupal, a powerful and extendable Content Management System (CMS), to set up and manage a social networking web site using a range of powerful and feature-rich social networking modules that are available. By using Drupal, the site can be built and extended rapidly, and changed easily, as the social network evolves and grows. This book is packed with practical tips not only for setting up a social networking site, but also for promoting and marketing the site, as well as working with the sites' users to help the social network grow and flourish. What this book covers Chapter 1 introduces you to Drupal, social networking, and the benefits of creating a social networking site. Chapter 2 takes you through the Drupal administration interface in addition to discussing how Drupal works. It also walks us through preparing Drupal to become a social networking site. Chapter 3 goes through the steps of allowing our users to contribute content to the site, using modules which are built into the Drupal core. Chapter 4 extends the user experience with enhanced customized profiles and blog themes; and enables users to log in using OpenID, which can save them the trouble of remembering another set of login details. Chapter 5 enables users to interact with one another, as well as build and maintain relationships with each other, forming groups to enhance these relationships and improving site communication and collaboration, and providing areas for users to comment on each other's profiles and viewing the activity of the other users. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Preface [ ] Chapter 6 looks at communicating with the users of the social network through mailing lists, theme changes and Twitter feeds, to keep them up-to-date, and improve user retention. Chapter 7 walks through the creation of a custom module, making use of Google Maps, to illustrate how easily the social network can be extended to meet almost any need. With these skills, the features provided on the social network are no longer limited to the Drupal core and user-contributed modules. Chapter 8 introduces you to Drupal themes to install and enable new themes, customize existing themes and walks you through the basic steps involved in creating a basic theme of your own, allowing you to provide a unique design to separate your site from the competition. Chapter 9 shows you how to deploy your new social networking web site, and also how to maintain it to ensure that it is in tip-top condition. Chapter 10 goes through some useful stages in promoting your site through search engine optimization, social media and advertisements, as well as some useful advice on advertising, promoting, and marketing on the web. This helps to bring back visitors to your site, and also bring in new users. Appendix A shows you how to install the Apache web server, the PHP interpreter and MySQL database server using the WampServer package. What you need for this book Drupal is a free, open source module web application framework and CMS written in PHP that can run in many environments including Windows, Mac OSX, Linux and FreeBSD. All that is required is a development environment set up on your computer such as WAMP, or XAMPP. To deploy the web site on the Internet, you will need a web hosting account and a domain name. More information on web hosting providers and domain name registrars is provided in Chapter 9. Who is this book for This book is for anyone who is interested in creating a social networking web site and would like to make use of Drupal to do so. This book does not assume you are familiar with Drupal. However, some experience with PHP, HTML and CSS will be useful for some parts of the book, although it is not mandatory. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Preface [ ] Conventions In this book, you will find a number of styles of text that distinguish between different kinds of information. Here are some examples of these styles, and an explanation of their meaning. Code words in text are shown as follows: "We can include other contexts through the use of the include directive." A block of code will be set as follows:

content

When we wish to draw your attention to a particular part of a code block, the relevant lines or items will be made bold:

content

New terms and important words are introduced in a bold-type font. Words that you see on the screen, in menus or dialog boxes for example, appear in our text like this: "The taxonomy options can be accessed from the menu via Administer | Content management | Taxonomy". Warnings or important notes appear in a box like this. Tips and tricks appear like this. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Preface [ ] Reader feedback Feedback from our readers is always welcome. Let us know what you think about this book, what you liked or may have disliked. Reader feedback is important for us to develop titles that you really get the most out of. To send us general feedback, simply drop an email to feedback@packtpub.com, making sure to mention the book title in the subject of your message. If there is a book that you need and would like to see us publish, please send us a note in the SUGGEST A TITLE form on www.packtpub.com or email suggest@packtpub.com. If there is a topic that you have expertise in and you are interested in either writing or contributing to a book, see our author guide on www.packtpub.com/authors. Customer support Now that you are the proud owner of a Packt book, we have a number of things to help you to get the most from your purchase. Downloading the example code for the book Visit http://www.packtpub.com/files/code/6101_Code.zip to directly download the example code. The downloadable files contain instructions on how to use them. Errata Although we have taken every care to ensure the accuracy of our contents, mistakes do happen. If you find a mistake in one of our books—maybe a mistake in text or code—we would be grateful if you would report this to us. By doing this you can save other readers from frustration, and help to improve subsequent versions of this book. If you find any errata, report them by visiting http://www.packtpub. com/support, selecting your book, clicking on the let us know link, and entering the details of your errata. Once your errata are verified, your submission will be accepted and the errata added to the list of existing errata. The existing errata can be viewed by selecting your title from http://www.packtpub.com/support. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Preface [ ] Piracy Piracy of copyright material on the Internet is an ongoing problem across all media. At Packt, we take the protection of our copyright and licenses very seriously. If you come across any illegal copies of our works in any form on the Internet, please provide the location address or web site name immediately so we can pursue a remedy. Please contact us at copyright@packtpub.com with a link to the suspected pirated material. We appreciate your help in protecting our authors, and our ability to bring you valuable content. Questions You can contact us at questions@packtpub.com if you are having a problem with some aspect of the book, and we will do our best to address it. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Drupal and Social Networking Welcome to Social Networking with Drupal 6! During the course of this book, we are going to learn how to use Drupal 6, a content management system, to create a social networking web site. We will install and configure Drupal, take a look at its features and see how it works. By using a combination of existing features, modules, and some simple custom development, we will enable user interaction, user contributions, and communication with our users. In this chapter, you will learn: What social networking is About social networking concepts What a content management system is What Drupal is Why Drupal is an excellent platform for social networking How to install and configure Drupal We will also discuss the social networking web site—which we will create during the course of this book—DinoSpace! a social network for keepers of pet dinosaurs. Social networking Social networking and social network services seem to be taking the Internet by storm, moving from large services such as Facebook and MySpace to simpler services such as Twitter and FriendFeed. But what exactly is social networking and what does a social networking service (like the one we will create in this book) do? • • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Drupal and Social Networking [ ] One of the fundamental concepts of social networking is building connections with other people. These connections and their connections build up a network of social links between users. With a network of contacts, it becomes easier to contact new people, perhaps someone who is a friend of a friend, or contact people you have lost touch with, such as old classmates. Obviously, using a social network to reconnect with people who you know or have known physically would require either a large social network (such as Facebook or MySpace) or a niche social network such as our DinoSpace scenario (why not reconnect with people you met at a recent dinosaur care conference?). Let's take a look at how these networks of contacts are built up. old classmates friends their friends... co-workers family you The network representation above shows the connections between contacts. Contacts of a contact can be easily discovered, making it easy to build up your own contacts to communicate and collaborate with new people. There is another side to social networks, and that is the community, contribution and collaboration aspect. Social networking sites generally allow interaction between users in a way that expands the social networking site itself, by contributing to the content of the site, communicating via discussion forums and blogs, making the site grow organically and become the product of all its contributors. Let's look at the collaborative and communicative features available on most social networks: Discussions, normally by means of a discussion forum Photograph galleries, allowing images to be shared with contacts, and in some cases associated with the people in them Custom profiles that allow users to share information about themselves with others Personal messaging and personal contact forms that allow users to communicate with each other directly • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 1 [ ] Many social networks also have the ability to work with information from other web sites and services, allowing you to bring together your information from other sites (such as tweets from your Twitter feed, photos from your Flickr stream, links from your del.icio.us profile, and so on), and to help find friends already on the web site using contacts from your email address book. These features are just the tip of the iceberg. If you are already familiar with social networking services such as Facebook and MySpace, then you will know that they provide a wealth of features and services for their users. If you are not familiar, why not sign up to a few services and have a look at what they offer; it might help you while planning for your own social network. There are also some less popular social-networking-type sites such as Twitter (www.twitter.com) and FriendFeed (www.friendfeed.com) which particularly work well with building friendships between people who don't actually know each other, whereas Facebook and MySpace are designed with "real life" friends in mind. Why create a social network instead of joining an existing one? There are already a number of popular and powerful social networks available, as I've mentioned above, so why would we want to create our own social network? Improve business—A social network can allow businesses to interact informally with customers, gathering feedback and in some cases giving value to the customer. One particular instance of this is that of radio stations advertising their web sites as social-network-type web sites, where listeners can get in touch, connect with other listeners, request songs, share photographs, and so on. Improve communications—Communicate with users informally, easily and cheaply. Provide a service—With the site we are going to create throughout this book, we will be providing a service through the exchange of knowledge and information relating to owning pet dinosaurs and having our own social network provide a fantastic platform for sharing and expanding this knowledge. They are fun! Social networks break down the barriers of time and distance, and are a good way to meet new people in a relatively safe way. Let's look into some of the reasons I've just listed which will answer why we should create our own social network, as opposed to using an existing one. • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Drupal and Social Networking [ 10 ] Improve business Existing social networks do allow us to improve business, because we can tap into their existing user base, which is great; but where it falls short is in providing extra enhancements. If we look at Facebook, additional features are created by third-party developers, and embedded as applications. Some of these applications add business functionality, for instance the one that allows users to make reservations for a local restaurant. The problem with such applications is that users are prompted for permission before the application gets any of their information (rightly so, as they are hosted by the developers who write them, and are different from Facebook). With the rise in the number of available applications, and the amount of "invitation spam" inviting users to add applications, many users are more careful and reserved when it comes to using applications within Facebook. With our own social network, we wouldn't need to worry about this. We would host all the information, and can provide exactly what we need—a streamlined social network (without adding extra features, bloating the web site). Enable communication Social networks are designed to enable and enhance communication. We have no physical barriers to communication (as being in a country different from another user isn't relevant). So, both an existing social network, and our own would improve communications. The advantage of having our own site is that we are less restricted in how we can communicate with our users. We can easily contact them and display information to them via any area of the web site, email, personal messaging and possibly via mobile devices too. Provide a service Many web sites and social networks provide services relevant to the social network, or to the target audience, such as linking with Amazon to show books a user has read, or a knowledge base of information. Services provided through other social networks, either via standard functionality they offer, or via third-party plug-ins (such as Facebook applications) would be restricted in a number of ways—firstly, by the terms and conditions of the social network, and later by how additional functionalities can be added. For instance, if we were to create a knowledge base for taking care of pet dinosaurs as an application in a social network, it relies on being promoted within the social network's web site (as it is difficult enough to try and promote a web site to new visitors, let alone a particular part of a web site). Its functionality and design is also limited to the provisions made by that social network for third-party plug-ins. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 1 [ 11 ] So why create a social network? It really comes down to the nature of what you want to offer the end users. If you want a social network to fill a particular niche, then creating one is probably the best bet. If you want to create a generic social network or a specific social networking feature for a generic audience, then utilizing an existing social network would be more productive, as you could harness their system and their user base. DinoSpace! Throughout this book, we are going to create our very own social networking web site using Drupal. This web site is called DinoSpace!, and it is aimed at the owners of pet dinosaurs (yes, I know, nobody really owns a pet dinosaur…it would be too expensive and impractical) to interact with one another. In particular, the web site aims to: Connect owners of pet dinosaurs and allow them to build and maintain friendships with other users Allow owners to share stories about their pets Help in promoting dinosaur-friendly places to visit Provide interactive help and support to fellow dinosaur owners Allow owners to chart their activities with their dinosaur Of course, the web site needs to enable more than just user-to-user interactions. It also needs to provide other content, and allow communication between us, the managers of the web site, and our users to keep them up-to-date. We are going to create our own social networking web site. To do that, we are going to use Drupal, an open-source content management system (CMS). So, let's look at exactly what a CMS is, and what Drupal is. What is a CMS? Before we look into exactly what a CMS is, let us look at the problem with web sites, which leads to the need for content management solutions. • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Drupal and Social Networking [ 12 ] Most web sites available on the Internet involve a degree of complexity, be it large web sites with a lot of content, or those dealing with dynamic user interactions, or those involving a number of different people updating different sections. Even small web sites can be complicated to manage, particularly if the design needs a change, or a particular piece of information needs a change on every page. One of the key features of a content management system is that it separates the design of a web site, the content of a web site and its business logic and features, making it easy to change any aspect of the web site independently without affecting the rest of the web site. Front End (User Side) Back End (Server Side) Website loaded into a users web browser CMS Content stored in a database Design Template Home Dino Space Contact About Welcome Hi! Welcome to the DinoSpace! website, why not sign up! The diagram above shows the separation of these key layers. It shows that when a visitor to the web site requests a page, the content management system takes the design template and the content from the database, combines the two along with some logic (such as seeing if the visitor is logged in, in which case it may display a username too) and then sends the result to the visitor's web browser. Generally, content management systems have the ability for users to do the following through their web browser: Create content Edit, delete and manage content Provide and restrict access to content, and to enable editing of content by the user's role within the web site • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 1 [ 13 ] Allow multiple users to easily edit and control different areas of a web site simultaneously Separate the design, content, and logic layers of the web site Collaborate effectively Manage different versions or drafts of content (referred to as revisions in Drupal) What is Drupal? Drupal is a free, open source content management system which allows individuals, or a community of users to easily publish, manage, and organize a wide variety of content on a web site. The project was started by Dries Buytaert, and is now assisted in development with a large community. One particular advantage with Drupal is its modular framework, which allows additional features to be plugged into it, in the form of modules. The Drupal web site maintains an extensive list of modules and themes (custom designs), which can be used for free. The Drupal web site address is www.drupal.org, and it contains the downloads, news and updates on Drupal, information relating to many of the modules, and themes which can be downloaded to enhance Drupal and discussion forums. Drupal as a social networking platform Because of the way Drupal is structured, it is very flexible in adapting to the needs of a wide range of different web sites. Permission to perform various actions such as creating content, writing a comment, writing a blog post and so on can all be assigned to different roles within Drupal, be it the role of an administrative user or the role of a standard user who is logged in. This means we can grant the permissions to contribute and help in managing the content of the web site to the users of the web site. Many socially-oriented features are included in Drupal "out of the box" (without the need to download extra files or modules) including: Blogs Forums Contact forms Collaborative content via the book module and also via permissions allowing users to edit different types of content, such as pages • • • • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Drupal and Social Networking [ 14 ] Drupal's modular framework, which I mentioned earlier, allows new features to be installed at a later time. There are many modules available, which are designed to enhance Drupal's ability to work and act like a social network. It also means that once our site is up and running, we can easily expand it at a later date with new modules to add extra functionality. Such modules include: Organic groups Extended profiles Blog themes Gravitar OpenID With Drupal being a content management system, we also have the advantage of having our site controlled and managed by ourselves, as is typical of most web sites, while the community can contribute to the other areas. Installing Drupal We know what Drupal is, we know what social networking is, and we know what we are going to create during the course of this book. So, let's get started! The first thing we need to do is install Drupal. This section contains some detailed technical information regarding the requirements and installation of Drupal. For most of the book, we will be working with Drupal installed locally on our own computers (see Appendix, for setting up a development environment if you don't have web server software installed on your own computer) as we build up our site. We will move it across to a live web site later. Requirements If you already have a development environment set up, which differs from the one detailed in Appendix, then you may need to make some adjustments to take into account the server requirements for Drupal. If you went through the process in Appendix, you will find that everything is set up and ready, and compatible with Drupal. Web server (Apache recommended, and used during the course of the book; IIS is also supported. However, other web servers have had limited testing) PHP 4.3.5 or greater (5.2 or higher recommended; this will be the minimum requirement once Drupal 7 is released) • • • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 1 [ 15 ] Database Engine: Either MySQL (4.1 or 5) or PostgreSQL (7.4 or greater). MySQL is assumed during the course of this book. To make use of friendly or clean URLs, mod_rewrite and the ability to use .htaccess files is required. However, it is optional. PHP's XML extension may be required to utilize certain XML-based services. This is also optional. The Drupal handbook contains more details on the requirements, http://drupal. org/requirements. There are also some guidelines on setting up your own development server environment on the Drupal web site at http://drupal.org/ node/260. However, in this book we are assuming the setup given in Appendix. Download We can download a copy of Drupal from the download page on the Drupal web site http://drupal.org/download. There are a number of download areas on the Drupal web site. But this one is specifically for the Drupal project (that is, the content management system itself), which is exactly what we want. The version we want to download is one from the 6.x range (at the time of writing, 6.5). So let's click the download link and download Drupal! Installation Now that we have downloaded a copy of Drupal 6, we need to install it onto our local web server. To do that we need to: Extract the Drupal files Create a database Run the Drupal installer The file we have downloaded is a compressed file containing all the individual files that make up Drupal. We need to extract this into the web folder in our development environment (see Appendix) using an unzipping program (such as WinZip, PowerArchiver or Windows' built-in "Compressed folders" system, or the default program for handling compressed files on your computer). Technical Installation Details There are more technical installation details available in the INSTALL.txt file, which is in the folder we have just extracted. • • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Drupal and Social Networking [ 16 ] We need a database for Drupal to store information such as the web site's content, details of our users, settings, and so on. PHPMyAdmin is a web-based tool for administering MySQL databases. Most web hosts provide access to it, and we have a copy on our local machine too. Let's log in to phpMyAdmin and create our database. Our local installation is located at http://localhost/phpmyadmin/. We will need to have our database username and password to hand (see Appendix A, if you are using that development environment). Most of the development environment software such as WAMP, XAMPP, and so on have a default username of root without a password. Once logged in there, we have the option to create a new database. Let's call it Drupal. Keep a note of the database name, as well as the database username and password, as we will need it in a minute when we run the Drupal installer. Now that we have our database, we can run the installer. To do that, we just need to visit the folder where we installed Drupal, using our web browser. This should be at http://localhost/drupal-6.2/. Since we haven't installed Drupal yet, visiting this page will take us straight to the installer, which initially asks us which language we would like to install it in. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 1 [ 17 ] After clicking Install Drupal in English, we are taken to the Database configuration options. We now need to enter the Database name, Database username and our Database password. This information is necessary, so Drupal can connect to the database and install the default data. We shouldn't need the advanced options. However, there may be times when we'd need it for some shared hosting providers. It allows us to set the server on which the database is stored (for us, it is our local machine, which is localhost; this is the value which is already set), the port the database uses (which can normally be left blank) and a prefix for the database. If you want to have more than one installation of Drupal from the same database, you need to enter a unique prefix for each of the installations. For our local installation, we don't need to worry about them. So let's click Save and continue. The installer then sets up the database, which would take a couple of minutes. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Drupal and Social Networking [ 18 ] Now that the database is set up, we need to provide some basic site information, the details for our administrator user account and a few server settings. The basic site information we need to provide is the name of the web site and the email address to be used by the web site when sending emails. Since our site is going to be called Dino Space! Let's enter it in the Site name field, and an appropriate email address in the Site e-mail address field. The next section is for the details of our administrative user account. This user account will have permissions to manage and control the entire site. To create the account, we need to supply a Username, an E-mail address, and a Password (which needs to be confirmed). This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 1 [ 19 ] I've entered Michael for the Username and my email address of michael@dinospace.net for the E-mail address, followed by my Password. You should enter a Username, E-mail address and Password of your choice. Drupal analyzes the Password you type in to check its security and suitability for use. Because this Administrator account can control the entire site, having an insecure password can leave the site vulnerable to the Administrator account being hacked into. If you enter a Password which Drupal thinks is too insecure, it gives you some tips (as shown in the following screenshot) to make your Password more secure. Here are some guidelines I generally follow when creating passwords which I feel is worth pointing out: Use at least eight characters Use letters and numbers—personally I like to use certain numbers as letters, for example, m1ch4el Use upper- and lowercase letters Add punctuation, for example, M1ch@eL If I'm using a word, I'd like to spell it incorrectly, for example, M1kh@3lL Finally, we have the server settings options. The only options required are the Default time zone, Clean URLs and Update notifications options. The Default time zone option is to determine the dates and times used throughout the site. So if we were to post an article on the web site, it would use the time zone set here when displaying the date and time the article was posted. The Clean URLs option makes the URLs generated by Drupal more user-friendly, and more search-engine, friendly too. This setting depends on the servers' setup. Some web servers cannot support clean URLs because of the way the pages are generated. However, Drupal does a quick test to see if our server supports them. The final option, if set, will notify us about the new versions of Drupal when they are available. • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Drupal and Social Networking [ 20 ] This is very useful, particularly from a security perspective, where some vulnerability in security may have been reported and fixed in a newer version. This will alert us to the availability of this version. The default time zone picked up should be the one set on our computer, and shouldn't need to be changed. We can enable Clean URLs, assuming our server supports them, and we should check the updates checkbox. Time zone and Clean URLs If you are installing Drupal direct onto a web hosting server, the time zone will be that of the server, which if located in some other country, may need to be set to match the time zone you prefer. Clean URL support may not be available; you should contact your web host if you are unsure about it or you need support. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 1 [ 21 ] Once we are done, we need to click the Save and continue button to complete the Drupal installation! We are now presented with a confirmation screen informing us that the Drupal installation is complete. You might have a few errors on this page relating to Drupal's ability to send email. This error message is expected, because we have installed Drupal on our local computer, and our computer probably does not have a built-in email server (although if you are running a Linux computer or a Mac, you may have one built-in, depending on your setup). This isn't something we need to worry about, as we won't need it to send emails until we deploy our web site live on the web! Clicking the your new site link takes us to our brand new Drupal installation. Configuring Drupal Since we have just set up Drupal, and created our user account, we are now logged into our new web site. On this front page, we have a link to the configuration section where we can configure our installation. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Drupal and Social Networking [ 22 ] The customize and configure link takes us to the Site Configuration page, which contains various sections of the options we can configure. Let us take a look at these options and what they allow us to do, and configure them for our DinoSpace site. Actions Actions are tasks which Drupal can perform, such as unpublishing a comment, making a post sticky, or sending an email. These actions can be performed by some of the modules within Drupal when triggered by a certain event. For instance, we could automatically set posts or comments containing links to the competing web sites to be unpublished. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 1 [ 23 ] On their own, these actions won't do anything, they need to be triggered. However, triggers are not enabled by default, different modules and custom development may introduce the need for actions and triggers later. Administration theme The Administration theme setting allows us to set a different theme when on the administration pages. A Theme is a collection of files, which make up the design, layout, and style of our Drupal web site. New themes can be added, modified, and applied to change the look of our site. In Chapter 8, Designing our Site, we will look at themes in detail. Since we don't know what these different themes look like, we can't yet make a judgement on whether we would prefer a different one for administering the site. The advantage of this is that if we were to have a very stylish image-heavy design for our site, we may opt for a simpler design for the administration options to make it easier and faster to administer the site, while keeping the site itself more visually appealing. There is also the option to use the Administration theme when editing and creating content, which is generally done outside the Administration section. Clean URLs We have already set the Clean URLs option, when we installed Drupal. But this section allows us to change this, and enable or disable the Clean URLs at any time, should we need to. We don't need to; so, let's leave this as it is. What is a clean URL? Without this option enabled, URLs in Drupal will look like this: www.dinospace.net/?=node/83; whereas with the option enabled, it will look like this: www.dinospace.net/node/83. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Drupal and Social Networking [ 24 ] Date and time The Date and time settings allow us to change the locale and format of the date and time used, including: The default time zone (which we set on installation). User-configurable time zones (to allow users to set their own time zones, which adjust the display of dates for them). This is already enabled, and makes a more enjoyable experience for users in another time zone, as it may be difficult for users to find out what time something was posted or replied to. The first day of the week, used for calendar views. Format of the short representation of a date. Format of a medium length representation of a date. Format of a long length representation of a date. The formatting settings are primarily a personal choice, I'm happy with them as they are, so I'm going to leave them at their defaults. Why don't you explore these options and adjust them to your personal taste. Error reporting Using the Error reporting settings, we can specify a page to redirect the user to if they try to access a page which either they have no permission to view, or which does not exist. We haven't actually created any pages yet. So we can't redirect our users. However, we will come back to this in Chapter 2, Preparing Drupal for a Social Networking Site. The other option on the page is with regards to displaying technical error messages generated by Drupal. The two options available are Write errors to the log and to the screen and Write errors to the log. These error messages are useful when developing and creating a site. However, displaying them to visitors can confuse them, as they will be technical, and can pose a security risk by revealing information on our site's setup. Let's change this to Write errors to the log. If we do encounter any problems, we can always check the log. • • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 1 [ 25 ] If you wish to leave it as it is, don't forget to change it to just the log when you put your site live on the web! Once we have made those changes, we can click on the Save configuration button, and then return to the configuration options by clicking the Site configuration link near the top of the page. File system The File system options determine where the files that we may allow our users to upload to our site or download from our site are stored. There are settings for: File system path—this is the location on the server where the files will be stored. Temporary directory—where uploaded files are stored during previews. Download method (either public or private)—Public downloads mean that anyone could gain access to the files as they are stored in a web accessible folder, whereas the private method would require Drupal to generate the download for the user. The Private method is useful, if we don't want guests to be able to download the files and only want registered users to access them. Changing the download method on a site which is in use can cause problems with the existing files. So now is the perfect time to change this if we need to. For DinoSpace, there is no reason to have the files tagged private, so let's leave these options as they are. • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Drupal and Social Networking [ 26 ] Changing the download method, and a note on the temporary path If you do change the download method, you should change the file system path to reflect a location which isn't accessible via the Internet, that is, outside your web site's root directory. The temporary path is generated automatically based on your server's settings; change this only if you know what you are doing. When working on a live web site in a hosting environment, your web host should be able to instruct how you should configure the file system path and the temporary directory settings, should you wish to change them, or use the private download method. Image toolkit Many web servers provide options for manipulating images, the most common ones are the GD image library and ImageMagick. We have the GD library installed (from Appendix A). However, we could remove this, or use the ImageMagick library instead. These libraries provide options for tasks including things like: Adding watermarks Changing the size of an image Cropping an image Converting the format of images Combining images The Image toolkit settings provide settings specific to the image library (or toolkit as Drupal refers to it) we have installed. With the GD library, the only setting is related to the quality of images which are manipulated by Drupal. By default, this is 75%, which means if we were to upload an image and we set Drupal to generate a thumbnail, the thumbnail image would only be 75% of the quality it could be. This option weighs the quality of the image over the size of the image. If we increase the quality of the images, uploaded images will be of a larger size, which may take longer to download, whereas if we reduce the quality of the image, we get lower file sizes, however, the quality of the images is reduced. Let's adjust this to 85%, as we want to use high-quality images on our site. If this becomes a problem, we can always change it later. You may find it useful to adjust this setting letter if the additional bandwidth is not an issue for you, or the quality of the image is too poor. • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 1 [ 27 ] Then we need to click Save configuration and return to the Site configuration page. Input formats Please note that this section is a little more advanced than the other settings pages, as it requires a little more technical understanding. The Input formats dictate how Drupal should process data which a user has supplied, and depending on the user, we may wish to assign a different format. The two formats available are: Filtered HTML Full HTML Filtered HTML only allows certain HTML tags, and automatically converts web addresses into links, and new lines into paragraphs where appropriate (although this can be altered). The Full HTML option allows all HTML tags, including things such as JavaScript which could potentially be harmful, if they were submitted by a malicious user. You should never offer this input format to people outside your circle of trust. This would be a serious security risk and should only be available to those who are trusted and involved in the creation of your web site, not general users of the site. HTML tags are used to structure a web site, for instance, a paragraph would be contained within

and

content

• • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Improving our Network with Custom Modules [ 194 ]

This file is a copy of the node.tpl.php file, with one map related addition, which has been highlighted in the code. This change is simply a div (division) where the map will display. When combined with a map in the database, and a number of places in the database, the div will be replaced with a Google map, which displays a specific area and plots the relevant points on the map. When a user clicks the point on the map, he/she is taken to the page of the place. node-venue.php The node-place.tpl.php file will be the design and layout template for the content of the type "venue", which will display information on a dinosaur-friendly place. This file is again a copy of the node.tpl.php file, with the following added above the $content line.

Map

This generates a static (not a JavaScript) map of the place on the page. Below this is then the description/comment left by the user who created the venue. Module files Although the map and venue functions have been referenced earlier as a single module, they will in fact be two modules. So a more accurate definition would be that they are a module package. Both modules will be required; we just need to physically separate things into two separate modules in order to get things working as required. Directories and locations Each of our two modules requires a directory to contain the relevant files related to them. For the moment, we will create the relevant folders outside our Drupal environment, while we develop the modules. We need to create a folder called map and a folder called venue. Once finished, we will put the files into our Drupal installation. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Improving our Network with Custom Modules [ 196 ] .info files As discussed earlier, the .info files contain information about the module, including its name, its compatibility with PHP and Drupal, and a description of the module. We can also provide a value for the modules package. This groups the modules together in the administration panel. Map module (map.info) The map.info file describes the map module in a few lines. ; $Id$ name = "Map Overview" description = "Display a map of dinosaur friendly venues" core = 6.x php = 5.1 package = DinoMaps The php and package lines are optional, though the package line ensures that the map and venue modules are grouped together. Venue module (venue.info) The venue.info file describes the venue module in a few lines. Note that the two info files have the same package value to ensure that they are grouped together. ; $Id$ name = "Venue Detail" description = "Display information on a specific dinosaur friendly Venue" core = 6.x php = 5.1 package = DinoMaps .module files The relevant .module files for our modules store the core functionality of the modules and define how they work and behave. Our .module files need to: Implement hook_helphook_help for the admin area to display a help line of text Display the relevant fields in the insert/update forms for the extra database data Insert data into the relevant database tables when a new content element of this type is created • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 7 [ 197 ] Update date in the relevant tables when a content element of this type is edited Delete relevant database records when a content element of this type is deleted Implement hook_nodeapi to allow individual revisions to be deleted Implement hook_load to load the custom node data Implement hook_view so that the frontend can access the node data Define permissions for the modules Control access based on these permissions These "hooks" allow modules to interact with the Drupal core. More information is available at http://api.drupal.org/api/group/hooks. Map module (map.module) We need the map module to do the following: Generate a map Generate a list of places Plot the places on the map Provide a link to details on places The module code for this, map.module, is shown below. Let's review it before we look at how it works. ' . $txt . '

'; } • • • • • • • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Improving our Network with Custom Modules [ 198 ] function map_node_info() { return array( 'map' => array( 'name' => t('Map Details'), 'module' => 'map', 'description' => t('A map of venues page.'), 'has_title' => TRUE, 'title_label' => t('Map Name'), 'has_body' => TRUE, 'body_label' => t('Map body'), ) ); } function map_form(&$node) { $type = node_get_types( 'type', $node ); if($type->has_title) { $form['title'] = array( '#type' => 'textfield', '#title' => check_plain( $type->title_label), '#required' =>TRUE, '#default_value' => $node->title, '#weight' => -5, ); } if($type->has_body) { $form['body_field'] = node_body_field( $node, $type->body_label, $type->min_word_count ); } $form['longitude'] = array( '#type' => 'textfield', '#title' => t('Central point longitude'), '#required' =>TRUE, '#default_value' => 0, ); $form['latitude'] = array( '#type' => 'textfield', '#title' => t('Central point latitude'), '#required' =>TRUE, '#default_value' => 0, This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 7 [ 199 ] ); $form['zoom'] = array( '#type' => 'textfield', '#title' => t('Zoom Level'), '#required' =>TRUE, '#default_value' => 0, ); $form['width'] = array( '#type' => 'textfield', '#title' => t('Map Width'), '#required' =>TRUE, '#default_value' => 0, ); $form['height'] = array( '#type' => 'textfield', '#title' => t('Map Height'), '#required' =>TRUE, '#default_value' => 0, ); return $form; } /** * Insert hook for when new maps are added. */ function map_insert($node) { // Insert the custom data in $node into the map table. $sql = sprintf( 'INSERT INTO {maps} (nid, longitude, latitude, zoom, width, height) ' . "VALUES (%d, '%s', '%s', '%s', '%s', '%s' )", $node->nid, $node->longitude, $node->latitude, $node->zoom, $node->width, $node->height); db_query($sql); // maybe: menu_link_save? } This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Improving our Network with Custom Modules [ 200 ] /** * Implementation of hook_update, for when a map node is updated. */ function map_update($node) { if ($node->revision) { map_insert($node); } else { db_query( "UPDATE {maps}" . "SET longitude = '%s', latitude = '%s', zoom = '%s', width = '%s', height = '%s' " . "WHERE nid = %d", $node->longitude, $node->latitude, $node->zoom, $node->width, $node->height, $node->nid ); } } /** * Implementation of hook_delete, for when a map node is deleted. */ function map_delete($node) { db_query( "DELETE FROM {maps} WHERE nid = %d", $node->nid ); } /** * Implementation of hook_nodeapi, for when individual revisions need to be deleted. */ function map_nodeapi(&$node, $op, $teaser, $page) { if ($op == "delete revision") { db_query( "DELETE FROM (maps) WHERE nid = %d", $node->nid ); This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 7 [ 201 ] } } /** * Implementation of hook_load for our custom data. */ function map_load($node) { $sql = sprintf( "SELECT longitude, latitude, zoom, width, height " . "FROM {maps} WHERE nid = %d", $node->nid); $result = db_query($sql); $obj = db_fetch_object($result); return $obj; } /** * Implementation of hook_view for our custom data */ function map_view($node, $teaser = FALSE, $page = FALSE) { $node = node_prepare($node, $teaser); drupal_set_html_head(""); $mapjs = ""; drupal_set_html_head( $mapjs ); return $node; } function map_perm() { return array( 'create map node', 'edit map nodes', 'delete map nodes', ); } function map_access($op, $node, $account) { switch( $op ) { case 'create': return user_access('create map node', $account ); case 'update': return user_access('edit map nodes', $account ); case 'delete': return user_access('delete map nodes', $account ); } } This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 7 [ 203 ] Venue module We need the venue module to: Display information about a venue Display a small, static map of the location Let's look at how this would be done: ' . $txt . '

'; } function venue_node_info() { return array( 'venue' => array( 'name' => t('venue Details'), 'module' => 'venue', 'description' => t('A venue page.'), 'has_title' => TRUE, 'title_label' => t('venue Name'), 'has_body' => TRUE, 'body_label' => t('venue body'), ) ); } function venue_form(&$node) { $type = node_get_types( 'type', $node ); if($type->has_title) { $form['title'] = array( • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Improving our Network with Custom Modules [ 204 ] '#type' => 'textfield', '#title' => check_plain( $type->title_label), '#required' =>TRUE, '#default_value' => $node->title, '#weight' => -5, ); } if( $type->has_body ) { $form['body_field'] = node_body_field( $node, $type->body_label, $type->min_word_count ); } $form['longitude'] = array( '#type' => 'textfield', '#title' => t('Venue longitude'), '#required' =>TRUE, '#default_value' => 0, ); $form['latitude'] = array( '#type' => 'textfield', '#title' => t('Venue latitude'), '#required' =>TRUE, '#default_value' => 0, ); return $form; } /** * Insert hook for when new venues are added. */ function venue_insert($node) { // Insert the custom data in $node into the venues table. $sql = sprintf( 'INSERT INTO {venues} (nid, longitude, latitude) ' . "VALUES (%d, '%s', '%s' )", $node->nid, $node->longitude, $node->latitude); This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 7 [ 205 ] db_query($sql); // maybe: menu_link_save? } /** * Implementation of hook_update, for when a venue node is updated. */ function venue_update($node) { if ($node->revision) { venue_insert($node); } else { db_query( "UPDATE {venues} " . "SET longitude = '%s', latitude = '%s' " . "WHERE nid = %d AND vid= %d", $node->longitude, $node->latitude, $node->nid, $node->vid ); } } /** * Implementation of hook_delete, for when a venue node is deleted. */ function venue_delete($node) { db_query( "DELETE FROM {venues} WHERE nid = %d", $node->nid ); } /** * Implementation of hook_nodeapi, for when individual revisions need to be deleted. */ function venue_nodeapi(&$node, $op, $teaser, $page) { if ($op == "delete revision") { db_query( "DELETE FROM (venues) WHERE nid = %d", $node->nid ); } } This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Improving our Network with Custom Modules [ 206 ] /** * Implementation of hook_load for our custom data. */ function venue_load($node) { $sql = sprintf( "SELECT longitude, latitude " . "FROM {venues} WHERE nid = %d", $node->nid); $result = db_query($sql); $obj = db_fetch_object($result); return $obj; } /** * Implementation of hook_view for our custom data */ function venue_view($node, $teaser = FALSE, $page = FALSE) { $node = node_prepare($node, $teaser); return $node; } function venue_perm() { return array( 'create venue node', 'edit venue nodes', 'delete venue nodes', ); } function venue_access($op, $node, $account) { switch( $op ) { case 'create': return user_access('create venue node', $account ); case 'update': return user_access('edit venue nodes', $account ); case 'delete': return user_access('delete venue nodes', $account ); } } This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 7 [ 207 ] .install files For the .install files, we need to convert our database structures for the relevant modules, into schemas compatible with the Drupal schema API. The .install file is used when a module is installed or uninstalled via the administration area, and can be used to easily add new tables to the Drupal database. The .install files contain three main sections: An implementation of hook_install An implementation of hook_schema An implementation of hook_uninstall The hook_schema implementation returns an array consisting of the database structure. The install and uninstall implementations apply and undo the changes defined in the schema implementation, making it easy to install and remove modules at the click of a button via the administration area. More information on the schema API is available on http://api.drupal.org/api/group/schemaapi/6 and http://drupal.org/node/146939, as well as in the Drupal Module Development book, http://www.packtpub.com/drupal-6-module-development/book. Map module (map.install) This is essentially the database structure we discussed earlier for the map module in the Drupal database schema. array( 'vid' => array( 'type' => 'int', 'unsigned' => TRUE, 'not null' => TRUE, 'default' => 0 ), 'nid' => array( 'type' => 'int', 'unsigned' => TRUE, 'not null' => TRUE, 'default' => 0 ), 'longitude' => array( 'type' => 'float', 'not null' => TRUE, 'default' => 0 ), 'latitude' => array( 'type' => 'float', 'not null' => TRUE, 'default' => 0 ), 'zoom' => array( 'type' => 'int', 'unsigned' => TRUE, 'not null' => TRUE, 'default' => 0 ), 'width' => array( 'type' => 'int', 'unsigned' => TRUE, 'not null' => TRUE, 'default' => 0 ), 'height' => array( 'type' => 'int', 'unsigned' => TRUE, 'not null' => TRUE, 'default' => 0 ), ), This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 7 [ 209 ] 'indexes' => array( 'nid' => array('nid'), ), 'primary key' => array('vid'), ); return $schema; } Venue module (venue.install) This is essentially the database structure we discussed earlier for the place module in the Drupal database schema. array( 'vid' => array( 'type' => 'int', 'unsigned' => TRUE, 'not null' => TRUE, 'default' => 0 ), 'nid' => array( 'type' => 'int', 'unsigned' => TRUE, 'not null' => TRUE, 'default' => 0 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Improving our Network with Custom Modules [ 210 ] ), 'longitude' => array( 'type' => 'float', 'not null' => TRUE, 'default' => 0 ), 'latitude' => array( 'type' => 'float', 'not null' => TRUE, 'default' => 0 ), ), 'indexes' => array( 'nid' => array('nid'), ), 'primary key' => array('vid'), ); return $schema; } Putting everything together We have now created our basic module, let's look at how it all fits together, and start using the module! Installing the modules We have installed a lot of modules over the previous chapters. So hopefully, this doesn't need to be reiterated. However, for completeness sake, here is how to install our modules: Move the map and venue module folders to the /sites/all/modules folder Move the templates into the relevant themes folder Enable the modules Use the modules • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 7 [ 211 ] To enable the modules, we simply check the relevant boxes in the administration area. Now that our modules are enabled, we can start using the modules. Creating a map To create the map, we simply go to Create content | Map. Here, we can enter the longitude, latitude, zoom level, width, and height of the map. We would want the permissions of this to allow only administrators or active contributors to create new maps. With a map created, we now need to create some places for our map! This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Improving our Network with Custom Modules [ 212 ] Adding a venue To create the venue, we simply go to Create content | Venue and enter the name, description and coordinates of the venue. Seeing the module in action Now that we have created some content which our modules can use, we can see our module in action! This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 7 [ 213 ] On the map, we have the place which we had added earlier. Clicking the point takes us to the place detail page, which provides further information on the place, and why it is dinosaur-friendly. We can also set the permissions for the venues to allow users to create content of the type place, so they can share their experiences of dinosaur-friendly hotels, restaurants, cinemas, and so on. Useful APIs There are a number of modules for Drupal that provide a framework and APIs to other web services and applications. The following are some useful examples. GMap This module provides an API / framework for working with Google Maps data (although we didn't use it in this chapter). http://drupal.org/project/gmap This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Improving our Network with Custom Modules [ 214 ] Facebook This module/API provides a wrapper that can be used by other modules, and new custom modules. There is a Facebook App module which makes use of it. So this can be used to provide core Facebook-related code. http://drupal.org/project/facebook_api Summary In this chapter, we quickly explored Drupal's modular system, and used it to create two modules which added some additional functionality that is relevant and is of use to our social network. This included creating .info, .module, and .install files for the modules as well as creating additional templates and database tables for them to utilize. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Designing our Site Our social networking site is feature complete, but at the moment, it resembles any other default Drupal installation, as we have kept the default theme in use. Let's take a look at how Drupal works with regards to themes and designs, and change the design of our site to something more appropriate. In this chapter, you will learn: About Drupal themes How to customize the default theme The basics of creating a theme So let's get started! Drupal themes The design (or "look and feel") of our site is controlled by the theme. Drupal provides us with a number of themes out of the box. Initially, one theme, which is the default, is enabled. So all users of our site experience the same look and feel. If we wish so, we can enable more than one theme, so that our users may choose the look and feel of the web site. Themes are administered via Administer | Site building | Themes. • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Designing our Site [ 216 ] Themes and our users The themes administration page lists all the themes available to us in our Drupal installation. To enable more than one theme for our users, we simply need to check the Enabled box next to the themes we wish to enable, and select the Default button if we wish this theme to be the default look and feel for the site. If they have permissions to do so, users can change the theme they use by editing their accounts. Grouped under Theme configuration is a list of the installed themes allowing the user to select the one they wish to use. The list of themes displays a thumbnail of the theme, so that the user can see at a glance and select the layout of the theme. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 8 [ 217 ] Pre-installed themes By default, Drupal has the following themes installed (although all but one is disabled): Bluemarine Chameleon Garland Marvin Minnelli Pushbutton Many of these themes are old and out-of-date, particularly with regards to the way they have been created. But there may be one which is a good starting point for a theme we wish to create. Let's have a brief look at these themes. Bluemarine Quite a corporate theme, this is a block-based theme with a very rigid menu and header. The layout is fluid, so the design adapts to the width of the user's web browser. Although a corporate theme, it has a less corporate feel than the Marvin theme, and is naturally less vibrant than themes such as Minnelli and Garland. • • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Designing our Site [ 218 ] Chameleon This is a very simplistic theme, making use of the whitespace and a white background. Older computers with poor color schemes may be better suited to use this theme, due to the lack of colors or dependence on images to achieve the design. Mobile devices too may work well with this theme. Garland This is the theme which is set to default on new Drupal installations. This is a fluid width theme (unlike Minnelli, which is a fixed-width version of this theme). This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 8 [ 219 ] The use of gradient color schemes in the header and menu, a fresh color scheme and the glassy effect logo is a style commonly used in web site design at the moment. Overall, it gives a modern, friendly, and welcoming feel to the site. Marvin A very corporate and simplistic design, it is useful as a starting point for a business web site. Further customization would make this theme look much better. Minnelli This is identical to the Garland theme, but with a fixed-width. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Designing our Site [ 220 ] Pushbutton This theme maintains a clean, professional look, and its use of typography seems to be designed with the visually impaired in mind. Contributed themes There are vast numbers of themes created by Drupal enthusiasts available on the Drupal web site, http://drupal.org/project/Themes. This web site lists available themes, as well as the Drupal version they were designed for. Screenshots of most of the themes are available, so we can see what the theme would look like. Don't forget When downloading themes from the Drupal web site, or elsewhere, ensure that they are compatible with the version of Drupal you have installed. Installing contributed themes To install a contributed theme (that is, a theme from the Drupal web site), we simply need to extract the contents of the downloaded file into the /sites/default/themes folder, so we can enable, and configure them from the administration area. The Zen theme is an excellent starting point for creating a different look from the typical Garland look. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 8 [ 221 ] Customizing the default theme Most themes can be customized slightly direct from the administration area. We can customize the following features of a theme: The color scheme Which elements are used in the theme (for instance. search box) The logo The favicon or the "shortcut" icon These settings can also be set globally for all installed themes, or individually on a per theme basis. Themes are customized by navigating to Administer | Site building | Themes and then clicking the configure link next to the relevant theme. Let's configure the default theme! Color scheme The colors used by the (Garland) theme can be changed in the color scheme group of settings. There are two options for changing the colors. We can either select a preset Color set from the Color set drop-down list, or we can create a custom color set based on the colors we define. • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Designing our Site [ 222 ] The color sets available include: Blue Lagoon—Selected by default; a bright, vibrant blue color scheme Ash—Dark grey color scheme Aquamarine—Green/Blue color scheme Belgian Chocolate—Dark red color scheme Bluemarine—Light blue color scheme; not as vibrant as blue lagoon and without a gradient Citrus Blast—Yellow color scheme Cold Day—Dark blue color scheme Greenbeam—Vibrant green color scheme Mediterrano—Orange/Red color scheme Mercury—Light grey color scheme with subtle gradient Nocturnal—Dark blue/grey color scheme Olivia—Light green color scheme with gradient Pink Plastic—Bright pink color scheme Shiny Tomato—Red color scheme Teal Top—Teal color scheme Custom—Allows us to select colors of our own choice Personally I like the Mercury color scheme, so I will use that for Dino Space. Custom color sets We can also define our own color set by selecting custom from the list. With the custom set selected, we should click in the relevant color box we wish to change, and click the color on the color wheel, which will then update the color used by the set. Color set preview The preview section beneath the settings for the color scheme updates to reflect the colors we have set, for instance, if we select Mercury as the color scheme, the Preview image updates to the following: • • • • • • • • • • • • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 8 [ 223 ] Toggle display The next group of settings is Toggle display, which allows us to select which additional elements of the theme are enabled. For instance, if we have the search module installed, we can select if a Search box is shown within the theme or not. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Designing our Site [ 224 ] Boxes which are disabled (that is, where we cannot check them) are related to features which are not enabled (for instance, if the search module was not enabled, we could not enable the display of the Search box). Logo image design At the top of the page, we have the Drupal logo. We can easily change this to a logo of our own choice, by uploading it from this area. Once a logo has been uploaded, it is then reflected in the web site, as demonstrated with my poorly designed logo below: Shortcut icon settings When you visit a web site, there is often a small version of the logo displayed next to the web address in the address bar; this is called a favicon. Similarly for uploading the icon, we can upload a favicon from the admin area. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 8 [ 225 ] The first stage in setting this icon is to actually create the icon file. Thankfully, there are a number of free online tools such as http://tools.dynamicdrive.com/favicon/ which allow us to upload an image and convert it into a favicon, which we can then upload to our site. Global settings A number of the settings we have looked into with our default theme can be configured on a global basis for all the available themes. The settings which can be configured globally include: Toggle display (including a few extra ones not available in the default skin, as not all elements are supported by all skins) Content which contains additional post information Logo image settings Shortcut icon settings Creating a theme: The basics Creating a theme is a very large topic, and here we are going to cover it only very briefly. For more detailed information, please consider the following: Drupal Theme Guide - http://drupal.org/theme-guide Drupal 6 Themes by Ric Shreves, published by Packt Publishing (http://www.packtpub.com/drupal-6-themes/book) Knowledge of HTML, CSS and some PHP would be very beneficial for this section. • • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Designing our Site [ 226 ] Important disclaimer The theme we create here is designed to illustrate how to create a theme quickly, based on an existing template. It is not designed to be a guide on best practices for theme design and creation. The resources mentioned earlier should help as a more comprehensive guide to creating themes. This just illustrates how easy it is to change the design of a Drupal site. When making this theme, you may wish to set your administrative theme to Garland, so that any changes made by the theme don't affect the administration area, so you can easily disable the theme if need be. Theme structure A theme is made up of the following files: An info file, which is required Template files A template.php (optional) A logo and a screenshot (optional) Info file This is a configuration file, which is named with the same name as the theme, with the extension .info, for example, dinospacetheme.info. An example .info file is shown below: name = Dinospacetheme description = Theme for the dinospace website version = 1 core = 6.x engine = phptemplate stylesheets[all][] = style.css This tells Drupal that our theme is called Dinospacetheme, that it is compatible with Drupal 6, and that the main style sheet which it will use is called style.css. • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 8 [ 227 ] Template files The main aspect of a theme is of course, the templates files themselves. These contain the HTML which makes up the sites design, as well as PHP code to dynamically insert content, menus, and other site information. We need to create the following template files: page.tpl.php node.tpl.php comment.tpl.php block.tpl.php The page.tpl.php file is for pages, the node.tpl.php is for all nodes and content, and is inserted dynamically into the page.tpl.php template; the comment.tpl.php is for comments and block.tpl.php is for any blocks that may be displayed. Template.php The template.php isn't required, and can be used to store any conditional logic, or pre-process functions (http://drupal.org/node/223430). We are not going to use a template.php file in our theme. Logo and screenshot A screenshot helps users get a quick preview of the theme, if they are considering using it, and can also help remind us (administrators) as to what the theme is, if we were to change the themes that are enabled, at a later date. The logo is the logo shown in the header. Other files for themes Themes can consist of more than what we have already mentioned. For instance, we could create sub-themes, in which case, a theme would need to contain the sub themes. Themes can also contain color variations, in which case, we would need a color directory containing a color.inc file. • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Designing our Site [ 228 ] Getting started One of the easiest ways to get started is to copy the default theme and replace the files within it with the files for the new theme by taking an HTML template for a design, and breaking this apart to form the various template files we need. We are going to use the template as shown in the following screenshot: This template has the following HTML: pagetitle This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 8 [ 229 ]

Login

block

Block

block

Welcome to Dino Space!

Donec ut leo. Aenean justo. Nam risus ante, malesuada ut, blandit id.

This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Designing our Site [ 230 ] Nulla quam sem, consequat vel, dapibus sit amet, tristique nec, justo. Nulla facilisi. Fusce risus sem, blandit eu, consectetuer sed, gravida a, dolor. Sed ut felis vitae urna tempus imperdiet.

What is Dino Space?

Duis venenatis. Etiam eget elit. Nulla fermentum tincidunt arcu. In tincidunt lectus in dui. Donec semper venenatis orci. Cras iaculis porta velit. Nam congue. Ut pulvinar condimentum magna. Vestibulum in dui in libero condimentum mollis.

Suspendisse tortor. Duis nec nisl. Nam rutrum tincidunt ligula. Vivamus congue feugiat nisi. Vestibulum vehicula viverra est. Suspendisse non enim non diam tempor vulputate. Ut enim eros, sodales vel, facilisis ut, mattis non, ante.

The following CSS is used in the template: /* peacockcarter.co.uk 2006 - 2009 [ds] */ /* Reset */ address, caption, cite, code, dfn, th{font-style:normal; font-weight: normal} abbr, acronym{border:0} body, html{margin: 0; padding: 0;} blockquote, body, div, dl, dt, dd, fieldset, form, h1, h2, h3, h4, h5, h6, input, li, ol, ul, p, pre, textarea, td, th{margin:0; padding:0} caption, th{text-align:left} h1, h2, h3, h4, h5, h6, p, pre, blockquote{background:transparent; font-weight:normal; word-spacing:0px} This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 8 [ 231 ] fieldset, img{border:0} table{border-collapse:collapse; border-spacing:0; clear:both; margin:10px; width: 525px !important} /* Generic */ a, a:active, a:link,a:visited{background:transparent; color: #000; font-weight: bold;text-decoration:underline} a:hover{color:#2266BB; text-decoration: none} abbr, acronym, dfn{border-bottom-width:1px; border-bottom-style: dotted; cursor:help} address{color:#000; font-size:0.7em; line-height:1.8em} blockquote {} body{background: #FFF;color:#000; font-family: arial, verdana, helvetica,sans-serif; font-size: 62.5%;} caption{font-size:0.8em; font-weight:bold} em{font-style:italic} .float_left{float:left !important} .float_none{float:none !important} .float_right{float:right !important} .clear{clear: both !important} .hide {display: none !important} #nav,h1,h2,h3,h4,h5,h6 {font-family: verdana, sans-serif} h1 a, h2 a, h3 a, h4 a, h5 a, h6 a, h1 acronym, h1 abbr{border-bottom- width:0px !important; text-decoration: none !important} h1 a:hover, h2 a:hover, h3 a:hover, h4 a:hover, h5 a:hover, h6 a: hover{text-decoration: underline !important} h1{color: #2266BB;font-size:250%;letter-spacing:0; line- height:110%;margin: 0;padding: 0} h2 {color:#555; font-size: 200%;font-weight:bold; letter-spacing:0; line-height:150%} h3{color:#666; font-size:175%; font-weight:bold; letter- spacing:1px;line-height:100%;margin-top: 5px} h4, h5, h6{color:#555; font-size:1.1em; font-weight:bold; letter- spacing:1px;line-height:1.5em;margin-top: 5px} h2 a, h3 a {color: #555 !important; font-weight: inherit !important;} p, address {text-align:justify} ul{list-style-type:square} strong{font-weight:bold} caption{display: none} th, td {padding: 5px} th {background: #2266BB;color: #FFF;font-weight: bold} td {color: #555} /* Layout */ #wrapper { background: #FFF; margin: 25px auto 0 auto; This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Designing our Site [ 232 ] padding: 0 0 75px 0; width: 800px } #logo {} #header {color: #000;height: 80px} #nav { float: left; font-size: 100%; height: 52px; } #nav ul { list-style-type: none; } #nav li a { color: #330033; display: block; font-weight: bold; padding: 2px 5px; text-decoration: none; width: 210px; } #nav li a:hover { color: #2266BB; } ul ul { font-size: 75%; margin-left: 0 !important; padding-left: 25px !important; } ul ul li {border-bottom: 2px #FFF dotted;} ul ul li a {margin-left: 0 !important;width: 175px !important} .block { margin-left: 25px; padding-left: 5px; border: 1px solid #2266BB; } .block h2 {color:#555; font-size: 120%;font-weight:bold; letter- spacing:0; line-height:150%} /* Main */ #main {clear: both;font-size: 120%} #main p, #main ul, #main dl, #main ol { font-weight: normal; line-height: 135%; margin: 10px 0; } This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 8 [ 233 ] #main-content img {float: right;margin: 5px 0 5px 10px} #main ul, #main dl, #main ol {margin-left: 25px} #main-content { float: left; width: 475px } #content {background: #FFF;padding: 10px 25px} #column { background: transparent; float: left; padding: 10px; width: 250px; } #column p {font-size: 90%;text-align: left} #column img {float: right} #footer { background: #FFF; clear: both; color: #CCC; font-size: 90%; height: 105px; padding: 5px 10px 0 10px } #footer p {padding: 0 100px 0 25px} #footer a {color: #CCC} #footer a:hover {color: #CCC} We will need to break the HTML up into a number of template files, and insert the relevant PHP code to ensure that Drupal adds in our sites content. As this template was not designed with Drupal in mind, we may need to make changes to bits of it, as we go along. Info file We are going to create a theme called dstheme, which will use the phptemplate engine. So our .info file will be called dstheme.info and will contain the following: name = dstheme description = Theme for the dinospace website version = 1 core = 6.x engine = phptemplate stylesheets[all][] = ds.css This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Designing our Site [ 234 ] Template files One way to build the template files from the template HTML from earlier is to take the HTML and save it as page.tpl.php and place into it, some of the PHP code from the page.tpl.php file in the Garland theme. If we do this, and then install the theme, we should see how well Drupal links in with our HTML template, and also what we need to change to accommodate Drupal better. Page.tpl.php By merging the PHP from the Garland page.tpl.php file into our HTML template from earlier, we get this as the page.tpl.php file for our new theme. The PHP code which has been inserted is highlighted. <?php print $head_title ?>

'. $site_fields[0] .''; } $site_html = implode(' ', $site_fields); if ($logo || $site_title) { print ''; if ($logo) { print '

'; } print ''; } ?>

Login

block

This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Designing our Site [ 236 ]

'links primary-links')) ?> 'links secondary-links')) ?> '. $mission .'

'; endif; ?> '; endif; ?> '. $title .''; endif; ?> '. $tabs .'

'; endif; ?> '. $tabs2 .''; endif; ?>

This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 8 [ 237 ] When installed and viewed, this template appears as shown in the following screenshot: Obviously, there still remains a lot of work, but the basics seem to have been partially slotted into place. Some important points to be noted: The menu has automatically been placed in a div with a block class; the block style in our CSS was designed for blocks, and not the menu. To rectify this, we can change our CSS to rename block to blockd instead. The menu items have icons next to them. This is because Drupal includes a default stylesheet for the menus, which sets this. We will have to override this within our own CSS. • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Designing our Site [ 238 ] Node, block and comment templates are still those from the default theme, although for this example, it isn't important. The default menu element is not selected. This is because the selected element in the page is given a CSS class of active; so we need to accommodate this in our CSS. View source One useful tip to remember is to view the source of the Drupal-generated page in your browser, and make a note of any style classes it gives to areas of the design, as these can be overridden by your own CSS. To rectify these issues, the following additions to our CSS do the trick: .active{ background: #2266BB !important;color: #FFF !important} ul.menu { list-style-type: none !important; margin-left: 0px !important;} .blockd { margin-left: 25px; padding-left: 5px; border: 1px solid #2266BB; } .blockd h2 {color:#555; font-size: 120%;font-weight:bold; letter- spacing:0; line-height:150%} .block h2 {color:#555; font-size: 120%;font-weight:bold; letter- spacing:0; line-height:150%} .block ul{ list-style-image: none !important; list-style-type: none !important; } #block-user-0 {margin-left: 25px; padding-left: 5px; border: 1px solid #2266BB; width: 210px; } #block-user-0 ul {margin: 0px !important; padding:0px;} #block-user-0 li {margin: 0px !important; list-style-type: none !important; padding:0px;} The #block-user-0 styles are for the login box, to make them fit in with the original design template we started with, as you will see further on in this chapter. Template.php As we discussed earlier, we are not using a template.php file in our theme. • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 8 [ 239 ] Logo and screenshot The logo in our site needs to be named logo.png for it to be automatically placed in by Drupal, so that if we were to distribute the theme, other administrators could change the logo by uploading a new one in the administration settings. A 150px by 90px image saved as screenshot.png serves as the screenshot. In action And there we have it, a very quick and basic theme of our own. With some time and thought we could customize the theme to any style we like. We've only scratched the surface with the themes we have created. There are of course many other areas of the theme which need to have proper attention paid to them, such as the breadcrumb trail, the primary or secondary menus (if used), blocks, forms, and messages (for instance when a new page is created). This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Designing our Site [ 240 ] When we are logged out, our log in box is nicely styled thanks to the other additions we've made to the CSS. And of course, with the screenshot and various settings in the .info file, we have our theme listed nicely in Administer | Site building | Themes. Summary In this chapter, we looked at how to customize the look and feel of our site by: Enabling new themes Installing new themes Customizing themes Looking at the very basics of creating new themes By customizing the look and feel of our site, we have given our social network a unique look to ensure the site is distinctive and stands out. • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Deploying and Maintaining our Social Networking Site Our new social networking web site is now complete, with one very important exception. It isn't online, which means nobody can join it, and it can't grow! Once we do put our site online, we need to keep our web site maintained too. In this chapter, you will learn: How to keep your site secure How to protect your site from spam How to deploy your site How to maintain your site How to backup and restore your site Installing the modules As usual, let's install any module we will need during the chapter now, to save us time later. The modules we need are as follows and can be downloaded from the following: CAPTCHA—http://www.drupal.org/project/captcha reCAPTCHA—http://drupal.org/project/recaptcha Mollom—http://drupal.org/project/mollom Checkbox Validate—http://drupal.org/project/checkbox_validate Legal—http://drupal.org/project/legal • • • • • • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Deploying and Maintaining our Social Networking Site [ 242 ] These need to be downloaded, extracted to our modules directory, and then enabled so that we can configure and use them later. There are also some modules to look out for, as they are not currently available for Drupal 6. The Email verification module is one, which performs additional checks on email addresses entered when a user is registering to ensure that the address is valid. Another is the Login security module which provides protection from someone attempting to guess a user's password, including account locking, and delays to prevent such attempts from being successful. Other modules include the Flag content module and abuse modules. Security Our web site, once fully in use, will contain lots of personal information on our users, including their public profiles, their email addresses, and content they have contributed which may not be publicly viewable. We also have all the content on our site, which we want to keep secure. Essentially, security is important because we want to protect our web site and the data of our users. Because Drupal is an open source project, with fully readable code, we have both additional protections and risks regarding security compared to other projects that are not open source. Since the code is readable, anyone can look through the code and potentially find security vulnerabilities. However, due to the nature of the Drupal community, it is also very easy to report bugs and security issues, and get them fixed and patched quickly: the community acts as a security auditor. Once an issue has been patched, we would then need to download the new release, and upgrade our installation, based on the upgrade documentation. Security announcements There is a section on the web site that is dedicated to security announcements, which makes it easy to keep up with the latest security patches released for the version of Drupal we are using. These security announcements are posted on this web site: http://drupal.org/security. It is also advisable to subscribe to the mailing list for security announcements on this page, so that we can receive security announcements via email. This saves us from frequently checking this page for updates; alternatively, there is also an RSS feed for the content on this page which we could subscribe to. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 9 [ 243 ] Securing our site So, what do the modules we installed do? reCAPTCHA—This module extends the CAPTCHA module and help prevent automated "web bots" from using and submitting forms, including registration forms, contact forms, and posting content. Mollom—This module comes into play in the unlikely event that an automated web bot is able to circumvent the CAPTCHA system. The mollom system checks whether the content submitted is SPAM. This can also prevent SPAM that is submitted by a genuine user, and can optionally fall back on a CAPTCHA system if it detects a SPAM posting. Legal module—This module adds a terms and conditions box to our sign up form, which users must read and accept before joining, informing them of the rules and policies of our site. CAPTCHA The Completely Automated Public Turing test to tell Computers and Humans Apart (CAPTCHA) module installs a test which proves you are human and prevents automated spam bots from signing up to our site. The module allows us to set up one of three types of tests for use at various points throughout the site, including posting a comment, registering, and contacting a user. The three different tests, or challenges, available are: Math Image Text Because we installed the reCAPTCHA module, we can also offer a reCAPTCHA-based test, which is seen as a large improvement over the Image test. Let's have a look at an example for each of these different challenges. • • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Deploying and Maintaining our Social Networking Site [ 244 ] Math The math challenge involves a mathematical question, such as 1 + 0, where the user must enter the answer in the appropriate text box. Image The image challenge presents the user with an image containing various characters, the user has to read these characters and enter them correctly in a text box. This challenge can be configured using the Image CAPTCHA tab in the CAPTCHA administration area. This allows us to set the font, the level of distortion in the background, and so on. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 9 [ 245 ] Text The final test available by default is the text challenge, which asks for a portion of a phrase that is displayed to be entered correctly into a textbox. reCAPTCHA The image CAPTCHA is the most effective test available. However, the quality of the images available with the module is very poor. reCAPTCHA is a very popular CAPTCHA service, and requires a little bit of configuration to get the set up done. We need to do the following: Download the reCAPTCHA library Sign up for an API key Enter the public and private keys provided to us The configuration is described in the reCAPTCHA documentation page: http://drupal.org/node/151588. Download the reCAPTCHA PHP library If we go to the module configuration page (Administer | User management | CAPTCHA) and then click the reCAPTCHA tab, the following message appears at the top of the page: The reCAPTCHA PHP library was not found. Please install it into sites/all/modules/recaptcha/recaptcha. To download the reCAPTCHA PHP library, we just need to click the link in that message, which then takes us to http://recaptcha.net/plugins/php/index. html. From here, we then simply click the download link. With the file downloaded, we simply need to extract the files into the /sites/all/modules/recaptcha/ recaptcha folder. • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Deploying and Maintaining our Social Networking Site [ 246 ] Signup for an API key Next, we need to click the registered at reCAPTCHA.net link on the reCAPTCHA module configuration page to sign up for our public and private keys. By clicking the link in the settings page, it passes over our web site address to prepopulate the Create a reCAPTCHA key form. The first stage is to register or log in to the reCAPTCHA web site, and then we are asked to create a key. Because we have not deployed our site yet, the domain is populated with localhost. We can either accept this, and change the key to the value of our live domain later, when we deploy our site (as the key will only work with that domain), or we can check the Enable this key on all domains (global key) to ensure that it will work when we deploy the site, without any additional changes.. Once we have selected that, we need to click the submit button, and we are taken to a page containing a Public and Private key. Enter our public and private keys Next, we need to copy and paste these keys into the relevant text boxes on the reCAPTCHA module configuration page. And then click the Save configuration button at the bottom of the page. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 9 [ 247 ] reCAPTCHA in action If we now visit the examples page (Administer | User management | CAPTCHA), and then click the Examples subtab (admin/user/captcha/captcha/examples), we can see an example of this type of CAPTCHA test. Now all that is left to do is set up the module so that the reCAPTCHA test is displayed to users at certain points on the site. Setting it up The module can be set up and configured from Administer | User management | CAPTCHA. Apart from setting up the module, we can also configure the image and text challenges via the tabs at the top of the page. To enable the CAPTCHA challenges on certain forms, we just need to select the type of challenge we wish to enable for the relevant forms using the Challenge type per form option. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Deploying and Maintaining our Social Networking Site [ 248 ] We can also set a short description that is displayed when a user is asked to complete a CAPTCHA challenge, perhaps to apologize for the inconvenience caused by the challenge, and explain why it is necessary for users to prove that they are genuine. To prevent users from being continually pestered by the request to prove they are indeed human, we can alter the Persistence of the module to only challenge a user once, or to only challenge a user once for each type of form, and then not challenge them again. Finally, we have the option to log the wrong responses. This is sent to the log within Drupal, and can be useful if we have users complaining that they cannot get through the CAPTCHA system. Mollom Mollom provides two main services. It analyzes text to determine if the contents is SPAM, and it also offers CAPTCHA. If we wish, we can even use its CAPTCHA features in place of the CAPTCHA features set up with the reCAPTCHA and CAPTCHA modules. Let's set up mollom to work alongside our current CAPTCHA setup, but with an additional backup of its own CAPTCHA system (in case it detects a SPAM posting). This works by sending certain form submissions such as a new page, comment or forum post, to the Mollom web service for analysis. If Mollom determines this to be a SPAM, the user is then asked to complete a CAPTCHA test. As with reCAPTCHA, we need to sign up for public and private keys, as per the instructions mentioned on the Administer | Site configuration | Mollom page. These instructions contain links to the appropriate sign up page for Mollom. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 9 [ 249 ] Once we have signed up, we need to enter the public and private keys into the appropriate boxes before clicking the Save configuration button. The Mollom page then reloads, with a Site usage statistics section and Spam protection settings. The Site usage statistics section is an empty graph, which once our site starts making use of Mollom, will display a graph of spam attempts, and non-spam (ham) posts. Since we have reCAPTCHA setup for the contact form pages, and registration forms, we should select the No protection option for these within Mollom. However, for content such as forum topics, book pages, and so on, we should use Text analysis and CAPTCHA backup. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Deploying and Maintaining our Social Networking Site [ 250 ] Legal Under Site configuration, we now have a link to configure the Legal module. The options available for the module include: How the terms and conditions should be displayed; this can either be a scroll box of the content, some HTML text, or a separate page The Terms & Conditions Any additional checkboxes we wish to have (for instance, if we ran an over-18's social network, we could have a checkbox to indicate that the user is over 18) An explanation of changes made to the terms and conditions, which is displayed to users who signed up under a previous set of terms, so they know the new terms of the site With terms and conditions in place, users are asked to accept them, as shown here: This module is not yet compatible with the OpenID module. • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 9 [ 251 ] Passwords As the web site owner, our passwords can provide access to the administration area of the web site. Our hosting account password also gives complete access to our web site (even elements which may not be powered by Drupal), databases, emails, and statistics; so it is important that we use secure passwords. Passwords which are not secure can be obtained by random guesses, automated dictionary attacks where a computer goes through a list of words trying them as the password, or through social engineering. Unfortunately, the Login security module is not yet available for Drupal 6. This module would provide an additional layer of protection from this form of attack, by locking accounts after a number of incorrect login attempts; so do keep an eye out for the progress of that module, and other similar modules. Strong passwords are generally difficult to guess. Here are some suggestions for creating a strong password: Use both letters and numbers. Make use of special characters such as @, /, \, #, *, and so on. Make all of your passwords unique. If the passwords are the same for every login, guessing your Drupal password will enable access to your personal email, other web sites you are a member of, and so on. Include spelling mistakes, to make the word harder to guess. Don't include personal information such as date of birth, names of family members, and so on. Consider using numbers in place of some letters. Deploying To put our web site online, we need to do the following: Register a domain name, for example, www.dinospace.net Set up a hosting account Create a database on the hosting account Upload our database to the hosting account Upload our site to the hosting account Tweak the settings to point to the new database • • • • • • • • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Deploying and Maintaining our Social Networking Site [ 252 ] Hosting and domain names There are many hosting providers and domain name registrars available, and as such, prices are generally quite competitive. When looking for a web host, it is important to keep in mind the amount of web space required, bandwidth (amount of data that can be transferred from your web site to your users per month), service level agreement, minimum contract term, acceptable usage policy and of course the cost. Most hosting accounts come with access to a web-based control panel to make many administrative matters easy, such as setting up email accounts, creating databases and so on. cPanel and Plesk are two of the most common control panels available. This chapter assumes that you have a hosting account with cPanel, although the instructions can easily be adapted to any control panel. If you would like more information and help with the cPanel hosting control panel, you may find cPanel User Guide and Tutorial by Aric Pedersen ISBN 978-1-904811-92-3, published by Packt Publishing (www.packtpub.com/cPanel/book), useful. www.webhostingtalk.com is a popular forum discussing web hosts, and comparing different hosting companies. It may prove useful when choosing a hosting account. Some popular web hosting providers include: 1&1 Internet Inc (www.1and1.co.uk) A Small Orange (www.asmallorange.com) Site5 (www.site5.com) MediaTemple (www.mediatemple.net) The domain name is the address which points to the hosting account (for example, www.dougsdinos.com). Because of competitive prices you shouldn't expect to pay more than USD$10 per year for a domain name. Some popular domain name registrars include: NameCheap (www.namecheap.com) GoDaddy (www.godaddy.com) Once you have registered a domain name, you will need to point it to your web hosting account by changing its nameservers to those of the hosting accounts. Your host should be able to provide information on the nameservers you will need to use, and your domain name registrar should be able to provide information on updating your domain nameservers. • • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 9 [ 253 ] Getting the site online Now that we have a registered domain name and a hosting account, we can put our social networking site online. To do this, we need to: Create a user account for the database Create a new database Assign the user account permissions to that database Upload our site Import the database Updating a setting to tell the site to use the database on the hosting account Uploading Files To upload the files to our web hosting account, we need an FTP client. There are a number of products available that are both free and commercial. I would recommend using FileZilla (http://filezilla-project.org/) for this purpose. Setting up the database Firstly, we need to log in to our control panel (this is usually www.yourdomain.com/ cpanel), find the Databases section, and click the MySQL Database Wizard icon. The first stage is to enter a name for the new database. Normally, this is combined with the hosting accounts usernames, so the database name dinos would become dinospac_dinos. Once we have entered a name, we need to click Next Step, to move on to the next stage of the database wizard. • • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Deploying and Maintaining our Social Networking Site [ 254 ] Next, we need to create a MySQL user which will connect to the database server to access the database we have just created. It is important to use a secure password, we can use the Generate Password button to have cPanel automatically generate a secure password for us. Once we have done that, we need to click the Next Step button. Now that we have a database and a database user, we need to grant permissions for that user to be able to manage the database. Let's check the ALL PRIVILEGES checkbox and click the Next Step button again. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 9 [ 255 ] We now have a database, and a Username and Password to connect to the database. The next stage is to import the database from our local installation to the database on our web hosting account. Importing the local database This is a two step process. Firstly, we need to export the local database, and then we need to import it into the database in our web hosting account. The database can be exported from our local phpMyAdmin installation (comes included with most local web server setups, for example, WAMPServer). We need to open http://localhost/phpmyadmin/ in a web browser. From here, we need to select the Database we are using from the drop-down list. With the database selected, the page should reload the display of a number of tabs across the top of the screen, and a list of tables in the database in the main area of the window. We need to click the Export tab at the top. From here, we need to ensure that all the tables are selected (we can click Select All to make sure they are), scroll to the bottom of the page, and check the Save as file box, before clicking Go which will prompt us to download the database export. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Deploying and Maintaining our Social Networking Site [ 256 ] Now that we have the database from our local installation saved, we can import it into the database on our web hosting account. From our cPanel control panel, we need to click the phpMyAdmin link. If we have more than one database setup, we need to select it from the list (as we did with our local version). If not, we just need to click the database from the left hand pane. Next, we need to select the Import tab from the top of the window, so that we can import the database. From this window, we can browse for the database file on our computer using the Choose File button and then clicking the Go button at the bottom of the page. We now have our database setup on our hosting account! Uploading the site The next stage is to upload our site onto our web hosting account. To do this, we need an FTP client, such as FileZilla. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 9 [ 257 ] We need to enter our domain name, web hosting account Username and Password into the relevant boxes, and then click Quickconnect. Once we are connected with our FTP client, we need to navigate to the public_html/ folder in the Remote Site pane (this may be htdocs, or something similar depending on the hosting control panel you use). In the Local Site pane, we need to navigate to our Drupal folder, simply select all the files, and drag them into the Remote Site pane to upload them to our web hosting account. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Deploying and Maintaining our Social Networking Site [ 258 ] Changing the database settings With the web site and database uploaded, we now need to update the settings file in our Drupal installation to point to the database on the hosting account. The database connection details are located in the settings.php file (in the sites/default folder). We need to download this file, and open it with a text editor (or a PHP editor such as the Crimson editor). Within this file, we need to find the line starting with $db_url, and update this line to contain the database name, username, and password that we set up in our hosting account. This needs to be in the following format: mysqli://database_user: database_password@localhost/database_name. Once we have updated this, we need to re-upload the file, and our web site is now accessible via the Internet! Maintenance From time to time, we may wish to perform some maintenance on our site. Let's look at three common ways of maintaining our installation. Automated maintenance—Cron Making changes and updating our site Analyzing Drupal reports and performing maintenance accordingly Cron Cron is the automated execution of tasks by our server. Many of Drupal modules perform regular maintenance tasks (for example, pruning log files). By using cron, these tasks can be automatically performed at specific intervals. Setting up cron jobs is quite technical, and also depends on your hosting provider, as not all hosting providers allow cron jobs to be run. You should contact your web host for more information on setting up a cron job. • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 9 [ 259 ] The Drupal handbook online contains more information about setting up cron. http://drupal.org/cron. Performing maintenance When we decide to make some major changes to our site, it would be a good idea to put the site into maintenance mode. This prevents other users from accessing the site at a time when they are more likely to experience errors resulting from changes being made while they are browsing the site. There is a maintenance option within Drupal specifically for this purpose. It turns the web site offline to our users, and displays our message. This option is found under Administer | Site configuration | Site maintenance. From here, we just need to select the Site status as Off-line, and enter a Site off-line message to be displayed to users trying to access the site. If we now go back to the homepage of the site, there is a message there to remind us (as an administrator) that the website is in offline mode, and our users won't be able to access the site. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Deploying and Maintaining our Social Networking Site [ 260 ] If we logout, we can see that the site is inaccessible, and we are presented with the message we set earlier. Logging into an offline site To log back into the site, we need to go directly to the user page, which will prompt us to login, for example, www.dinospace.net/user/ (?q=user if Nice URL's not enabled). Upgrading Drupal When new versions of Drupal are released, we may wish to upgrade to a newer version, especially if it is a new security release. Upgrading is quite a straightforward process. However, one thing we do need to be careful about is our modules. If we upgraded to a new major release of Drupal (for example, Drupal 7) we would probably find that most of our modules would not work. When new releases are available, with security updates, a message is displayed in the administration panel. Although the upgrade process may vary from upgrade to upgrade, the process generally involves: Downloading the new version of Drupal Backing up your web site Backing up your database Uploading the files from the new version to the site Visiting our site and accessing the update.php file to make any necessary database changes Of course, full detailed documentation is provided within each upgrade. Reports Drupal provides us with a number of reports in the administration area, which can advise us on the areas where maintenance may be required. These reports include: Recent log entries of various events that have been recorded, including users logging in, email problems, and actions relating to content Top "access denied" errors listing attempts by users to access content they are not permitted to see • • • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 9 [ 261 ] Top "page not found" errors listing the top access attempts to pages which don't exist on our site Available updates that list updates which are available for our modules and themes Status report which checks for problems with our site, for example, whether cron is setup How can these help? If we are finding a lot of access denied errors, then we are likely to have a link in a menu or page (which most of our users can see) to pages they shouldn't have access to. We should then look for this link and remove it. Similarly, if we are having a lot of "page not found" errors for certain pages, then we may have a link to a page which does not exist, and we should remove the link. Alternatively, it may be due to a page we removed. We could set up a redirect to a replacement page, or put up a page explaining why the page was removed. The available updates report can help us keep our modules up-to-date. While upgrading modules and themes, it is advisable to put the web site into maintenance mode, to prevent our users experiencing any errors. Backing up Taking regular backups of your site is important in case something were to happen to the web site, its hosting account, or even the server the web site is stored on. If we were to lose several weeks worth of community contributions, this could do some serious damage to our community. It is also worth checking backup procedures your web host may perform, as part of your service. The frequency of contributions and how active the site really is determine how frequently we need to backup. Initially, a weekly backup would probably be sufficient. However, as the site gets more active, we may wish to automate the process on a nightly basis. • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Deploying and Maintaining our Social Networking Site [ 262 ] Backing up with cPanel From the main cPanel interface in the Files section, there is a link to the Backups area. From here we can download a copy of our Home Directory (all of the files and most of our settings) and also a copy of the database. Clicking the relevant backup buttons will prompt us to download the backup files immediately. It is important to keep these files stored in place that is safe and secure. Restoring Backups are needed in case we have a problem and lose our data. However, if this does happen, we need to be able to restore our web site from the backups. Let's look at the restore process within cPanel. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 9 [ 263 ] Restoring within cPanel When logged into cPanel, we need to click the Backups button to go to the backups section, as we did when backing up the site. On the right hand side of this screen are the options to Restore a Home Directory Backup and to Restore a MySQL Database. To restore from the backups, all we need to do is browse for the file we wish to restore from, and then click Upload. Any existing database or home directory content will be removed; so do this only if you really need to. If you need to gain access to a specific file which you need to backup, decompress the home directory backup, look for the file and upload it to your site using an FTP client. Summary In this chapter, we looked at how to deploy our social networking site on the Internet, and how to maintain it using the maintenance mode, reports, and cron, and to keep everything running smoothly. We also looked into keeping backups of our site in case anything went wrong, and how to restore from a backup if we needed to. Hopefully, we won't need to use the restore feature. But it is important to know how to use it in case we needed to. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Promoting our Site We now have our social networking site up and running, and it is live on the Internet. However, without users viewing the web site, making contributions, and communicating with each other via the web site, our social network won't be successful. Bringing new users to our site is key to help it grow. So let's now look at how we can promote our web site! In this chapter, you will learn: About advertising your social network with ad space, pay per click ads, and newsletter ads How to avoid being penalized by search engines About social and viral marketing How to optimize your social network for search engines Online advertising On the Internet, there are many different advertising programs available, including: Simply purchasing advertisement space Professional advertisement networks Search engine advertisements Newsletter advertising Typically, both professional advertisement networks and search engine advertisements (that is sponsored links in search results and on-site advertisements provided by search engines) operate on a PPC (pay per click) basis, where you pay each time a user clicks on your advertisement and goes to your site. • • • • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Promoting our Site [ 266 ] Buying advertisement space Some web sites sell advertisement space, which can in some cases be a great way of generating new traffic, and bringing new users to a site. There are a few things to bear in mind when buying advertisement space on a web site, which are: Competition—Is the web site you are going to advertise on a competitor, or does the site compete in some way with yours? If it is a competitor, then it isn't the best place to advertise, nor is the site likely to accept your ad. We certainly shouldn't advertise our Dino Space site on sites such as Dino Spaces, Dino Community and other potential competitors. Relevancy—We wouldn't gain anything by advertising on a web site which isn't relevant. If it isn't relevant, then the visitors would have no desire to click the ad and come to our site. After all, visitors to an office supply store web site wouldn't be interested in participating in an online dinosaur pet owner community! Reputation—If the site you are advertising on isn't reputed, then you are not likely to get many visitors and you are also associating your site with one which is not reputable. Do some research and investigation on the web site first. Statistics—A relevant, non-competing and reputed web site isn't enough! The popularity of the web site you are advertising on is also important, especially if it is a paid advertisement. Web sites with a low number of visitors won't bring many visitors to your site; so make sure you know a bit about their statistics, or make sure you pay for a certain number of impressions on the site. Pay Per Click Advertisements With Pay Per Click (PPC) advertisements, as the name implies, you pay only when a visitor clicks on your ad and visits your web site. This is often seen as a better option than just paying for advertising space, because you pay only when you get a new visitor. With many of these services, you pay in advance, and can set daily and monthly budgets. Let's take a look at how PPC advertising generally works: First, we sign up with a network (see the next section for a few networks provided by search engines). We submit information about the web site, ourselves, and some billing information. • • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 10 [ 267 ] We select keywords we wish to target, such as dinosaurs, pet dinosaurs, caring for dinosaurs, dinosaur community and so on. These are keywords which a user might type into a search engine; or if the ad is shown on a web site, these may be the keywords on the site. Select a maximum amount to pay for each click (sometimes, this affects the position and frequency of display of our advert) as well as a daily and monthly budget. The monthly budgets mean that if we choose not to prepay, but to link a credit card to the advertisement network instead, our bill would not exceed the specified budget. Advertisers are often concerned about fraudulent clicks; a competitor could repeatedly click our advert, bringing in no genuine new visitors but costing us money! Thankfully, most advertisement networks have systems in place to detect this. Make sure you know if the advertisement network you sign up for has appropriate detection for fraudulent clicks, so you don't waste your marketing budget! Advertisement networks provided by search engines The following are links to some advertisement networks provided by three major search engines, which are reputed and used by thousands of people for advertising their web sites: Google (http://www.google.co.uk/intl/en/ads/) Yahoo! (http://sem.smallbusiness.yahoo.com/ searchenginemarketing/index.php) Microsoft (http://advertising.microsoft.com/search-advertising? s_int=277) Some of these networks allow both text and image ads, but generally, image ads are shown only in large ad units (when a web site owner opts to display ads on their site; they choose which size of ad-unit they wish to display. Large units typically consist of between four and six standard ads), and can be costly as such. • • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Promoting our Site [ 268 ] The future for PPC: Pay Per Action Some advertisement networks are starting to implement pay per action schemes, where instead of paying per click, you pay every time a user who clicked your advert completes a specific action. This could include signing up, or making a contribution (ideal for our site), or making a purchase. Newsletter advertising Similar to advertising on relevant web sites, we could advertise our social network on relevant email newsletters. Maybe there is a local dinosaur related organization which has an email bulletin. Advertising in such newsletters could help bring new visitors to the site. There are also a number of web sites that are dedicated to help you manage an advertisement campaign within email newsletters. Caution: Search Engine Penalization Most search engines use a number of different metrics to determine where a web site is positioned in a list of search results. Some search engines, such as Google have a metric (Google's is called Page Rank which factors in other things too) which is based on in-bound links, where a web site link from one site to another acts as a vote. Some web sites and businesses use this to their advantage, and offer to pay for advertising space on other web sites (normally ones which have a high ranking). Both the buying and selling of advertising in this way is not something which many search engines like. Google even has an online tool to report web sites that do this, which result in their rankings being penalized. Of course, there is nothing wrong with buying and selling advertising space. In fact, one of Google's core businesses revolves around advertising space. The solution is to alter how the link is structured. A traditional link is structured as follows: PacktPub If this was a paid advert on our site (or if we were buying the advert space on a site) we could structure the link like this: PacktPub This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 10 [ 269 ] The nofollow attribute signals to search engines that we don't wish the link to be counted as a vote for the web sites rankings. So if this was an advertisement, we would not be penalized by search engines for buying or selling advertising space for it, on a web site. It is important to note that there is nothing wrong with providing links to other web sites without the rel=nofollow attribute. The penalty is applicable only to those adverts which are bought or sold, but not containing this attribute, as this is considered a trick to fool the rankings. Things to keep in mind: Only purchase ads, or buy ads from reputed web sites. Don't buy or sell links. Always use rel='nofollow' for the adverts you are displaying on your web site which you are paid to display, and for adverts you have on other web sites. Beware of emails offering to pay to put adverts on your web site–they probably don't have the rel='nofollow' attribute. Don't risk your search engine rankings! Newsletters We have already spent some time looking at Newsletters. However, it is important to remember that they are a very important marketing tool, not just for reminding existing members about the site, but for collecting the email addresses of new users to the site, so we can email them and entice them back! Marketing materials Physical marketing materials are a fantastic way to promote a new web site. Unfortunately they have high costs associated with them; so with a low budget your target would be limited to a small geographical area. Starting with something simple and low cost such as business cards could help, not to act as business cards, but as mini ads. These could contain information about our social network, as well as its web address. They are great for distributing at relevant events, such as dinosaur conventions, or if you happen to be talking to someone who would have an interest in the site (perhaps someone who is having difficulty in bathing their T-Rex!). • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Promoting our Site [ 270 ] Social marketing We can use other (non-competing, obviously!) social networks to help promote our network, as most social networking web sites have provisions for user information and profile data, including web site addresses. We can add our URL to MySpace profiles, Facebook profiles, Twitter accounts, and so on, to try and provide that extra promotion to our site. Facebook has a new addition to its web site which allows business, bands, web sites, organizations and anything that isn't related to a personal profile to create their own page, providing additional information, as well as hosting a discussion forum, photo gallery, and other features. We can of course create a profile for our site and share it among our friends. Users of Facebook can also become fans of these pages, promoting the site among their own friends as well. Viral marketing Viral Marketing is a relatively new marketing concept, which revolves around utilizing social networks. One particular example of viral marketing is utilizing video sharing web sites such as YouTube, and promoting videos that advertise businesses, web sites, products or services by using them in the video. This technique is probably more suited to large social networking sites with large marketing budgets who are trying to promote a brand. Information on using YouTube in particular was recently posted on a technology blog called TechCrunch (http://www.techcrunch. com/2007/11/22/the-secret-strategies-behind-many-viral-videos/). Twitter Twitter (http://www.twitter.com/) is a social networking web site revolving around the concept of telling your followers / anyone who is interested, what you are doing at a particular moment, as you may remember from Chapter 6, Communicating with our Users. In Chapter 6, we focused on adding a Twitter feed to our site to provide mini-updates directly from the site. However, we can use it to bring in new members. If you have your own Twitter account, you can update your followers to changes or announcements related to your web site. One option is to create a Twitter account specifically for the Dino Space site, and use it to post information about the Dino Space site periodically. Existing members of the web site may be interested in "following" the Twitter account, making it easier for others to find our Twitter account, and subsequently our site! Twitter has recently added a new search feature, allowing you to search for specific keywords—a great way to track discussion of your site across the "twitterverse"! This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 10 [ 271 ] Social bookmarking Social bookmarking is a web-based method for storing and managing bookmarks. Sites such as dig, StumbleUpon.com and del.icio.us are examples of social bookmarking sites. When a user adds a site to their social bookmarking service, it is easier for others who use that service to find it. If they enjoy the link, it will be promoted, and will gain even more exposure. We can add social bookmarking links to the footer of every page in our site, which allows the user to submit pages to these social bookmarking services, and also help us improve our marketing. As there are a lot of different services, it is a good idea to make use of a service that allows users to send the links to the social bookmarking service of their choice. One example of such as service is Socializer (http://ekstreme.com/socializer/). This provides more information on the service, as well as some PHP code which we could add to our web site's footer for displaying the socialize link. Now if a user wants to share the link with others, they simply click the Socialize link and select the service they use. It may also be worthwhile to add a link to "share on Facebook" as that is not available with the Socializer service. A module has been created for a similar service, called AddThis (http://drupal.org/project/addthis). The Digg Effect/ Slashdot effect One thing to be aware of is the so called Digg effect/Slashdot effect. If a site submitted to services such as Digg is found to be popular, it can send a very large amount of traffic to the site, which can cause problems, if you are using a shared hosting environment. You may wish to discuss provisions for this with your hosting supplier. Search Engine Optimization Search Engine Optimization (SEO) can be a real traffic booster, as it makes our site more visible to search engines, easier for them to read, and makes our site seem more important and more relevant. There are two main aspects to Search Engine Optimization: on-site and off-site. On-site SEO On-site search engine optimization relates to making optimizations directly on the web site. This improves visibility and readability to search engines. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Promoting our Site [ 272 ] Meta Meta tags are tags stored in the head section of an HTML document, typically for information on keywords, description, and the author of the web site. This is not regarded very highly by search engines anymore, but it is still worth doing, particularly if different pages and sections have different meta data. There is a module which enables Meta tags to be set on a per node basis available at http://drupal.org/project/nodewords. Sitemap and webmaster tools Google has released some webmaster tools, including one that allows us to create a list of the pages within our site, rank them in the order of importance and specify the frequency in which those sections will be updated. This is then saved as an XML file and stored on the web site. Google can then read it and see which content it should check regularly, and which content it should check less regularly. This helps keep the web site more relevant to search engines. A module has been written to automatically create sitemaps. However, the Drupal 6 version is still under development; it is certainly worth keeping an eye on (http://drupal.org/project/xmlsitemap). Links A very simple trick is to make use of relevant keywords within sentences as hyperlinks and give them relevant title attributes, take the example of a products page. A poorly optimized link would be: To view our dinosaur care tips click here. The link has no context and no meaningful information, a more meaningful and search engine friendly link would be: Why not view our dinosaur care tips All these small changes do make a difference! Up-to-date content Keep content up-to-date! If the content on our web site is always the same, with rare changes made to it, search engines (and visitors!) will stop crawling the web site. Frequent updates make the search engines pay more attention to your site. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Chapter 10 [ 273 ] Off-site SEO Off-site search engine optimization is particularly useful for specific key words to obtain certain specified rankings in search engines. It relies on promoting the web site on other web sites; hence it is called off-site SEO. As we had discussed earlier, one of the metrics for a web site's position in search results are its inbound links. Commenting on web sites, blogs, forums, video posts, profiles and so on with web links can increase a web site's ranking. This should always be done with care, consideration and courtesy, for instance, with a link in your personal signature on forums. Spamming web sites with comments is a very bad practice. However, relevant and appropriate comments on relevant web sites and articles, with a link back to our site, is a good start. Many companies specialize in this form of SEO. So if it is something you are serious about, it is worth looking around to see what they can offer. Monetizing your site The other important consideration is to monetize your site. While your site may not be designed to make a profit, it may be useful to try and recuperate expenses such as hosting fees. Here are some simple options to get you started: Cafepress.com—Creates merchandise with your sites logo, and earns a percentage from the sales; this could be prominently promoted on the site Google AdSense—Advertisement blocks from Google on the site earn money on a per-click basis; alternatively, integrating a Google search feature provides a less obtrusive form of advertising Affiliate Marketing—Become an affiliate of sites such as Amazon, where relevant products can be promoted on the site, and a commission earned Summary In this chapter, we have looked at promoting our web site on the Internet using advertisements, advertising networks, other social networks and search engine optimization. Now you have your social network up and running, and you have some advice for promoting and marketing your social network—it is up to you to make it successful. Good luck! • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Installing WAMP In order to install Drupal and the various social networking modules on our own computer, we need a development environment to run it that includes: A web server PHP A database server (MySQL) Various PHP and web server libraries to utilize additional features WampServer is a package providing all of these, and more, for Microsoft Windows systems. Mac users may wish to take a look at MAMP (Macintosh, Apache, MySQL and PHP) at http://www.mamp.info/en/mamp/index.html, while Linux users will need to look for instructions for setting up LAMP (Linux, Apache, MySQL and PHP) on their particular distribution. Installing WampServer Now we know what we need to install; so let's get started! Downloading WampServer Firstly, we need to download the software from the Internet. WampServer is available at http://www.wampserver.com/en/download.php. From here, we click the DOWNLOAD WampServer 2.0 link which then takes us to SourceForce from where we download the web site. • • • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Installing WAMP [ 276 ] Installing WampServer Once downloaded, we need to install the software. First, let's open the file we have just downloaded. We may need to agree to some security dialogues before Windows allows us to install the software. You must be logged in as an administrator to install WampServer. The first window to be displayed warns us that we shouldn't try to upgrade from a previous version of WampServer and that we need to uninstall the older versions if any. Now, let's click on Yes so that the installation can continue. Next, we are presented with the installation splash screen; here, we need to click Next. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Appendix [ 277 ] Then we need to select the I accept the agreement button before clicking the Next button. Now, we need to select the location where we wish to install WampServer. If we are happy with the default location, we should click Next; otherwise, we should change the location first. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Installing WAMP [ 278 ] If we wish to add shortcuts to WampServer to our desktop, or to the Quicklaunch toolbar, we can do so by selecting the appropriate checkboxes before clicking Next. Before WampServer is actually installed, we are shown an overview of the options we have selected. We can click Install provided everything is fine, otherwise we need to click Back and make the changes if any. WampServer will then install onto our computer. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Appendix [ 279 ] Once the installation has completed, we are asked to confirm our primary web browser. By default, it selects the Windows Internet Explorer; if we are happy with that, we should click Open, otherwise we should look for an alternative browser. Next, the installation asks for the details for sending mails from PHP. On most installations, we won't be able to send mails from PHP scripts because we have no mail server installed; so just click Next. We now have WampServer installed; if we click Finish WampServer will start. Apache not starting? If WampServer doesn't start (the icon in the system tray will show red or orange) it may mean that something else is utilizing the computer port (Apache runs on (port 80) and programs such as Skype do this). So you may need to close other applications before trying to start WampServer. WampServer overview When WampServer is running, it is displayed in our computer's system tray alongside the clock. Clicking the icon displays a menu where we can configure our server, and start or stop various services. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Installing WAMP [ 280 ] Putting the server online would make the web pages on our computer accessible to other computers on our network, and potentially via the Internet. We can quickly start, stop and restart the services, configure each of them, open the folder containing our web site's files, and open our web site or database manager in a web browser. Configuring WampServer Within the WampServer menu, the Apache, PHP, and MySQL options allow us to configure the various services. We can install modules and add-ons to the different components, or we can edit the configuration files for them. There are the two main features that we will want to be enabled: GD for PHP Rewrite_module for Apache Configuration Files The my.ini, php.ini, and httpd.conf files are the configuration files for the three services, although we wouldn't need to edit these for our web site. However, it is important to know where they are, in case we do need to change them later, as they control how the software works. More information is available on their respective web sites. GD2 PHP's GD2 module is a graphics library that allows PHP to easily manipulate and manage images, including resizing images, recreating images, adding watermarks to images and so on. Drupal has a number of image features which require an image module to be installed with PHP. By default, GD2 is installed with WampServer; but it is important for us to confirm that it is enabled, and that we know where the setting is. PHP's modules are enabled and disabled by clicking the WampServer logo in the system tray selecting PHP and then the PHP Extensions. • • This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Appendix [ 281 ] From here, we can enable or disable the GD2 extension. Rewrite Module Apache has a module called rewrite which allows it to rewrite URLs, particularly to make them more friendly by rewriting URLs such as /home/about to index.php?s ection=home&page=about. Now, when a user types in the "clean URL" version, the web site interoperates this properly. Drupal's Clean URL's module makes use of this feature if it is available; so let's enable it! It can be enabled from Apache modules within the Apache menu. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Installing WAMP [ 282 ] Summary We have now installed the Apache web server, the PHP interpreter and MySQL database server using the WampServer package. We have also ensured that various options are enabled which Drupal will utilize later on for our social networking site. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Index symbols .info files about 196 map module (map.info) 196 venue module (venue.info) 196 .install files about 207 map module (map.module) 207-209 venue module 209, 210 .module files about 196 map module 197-203 venue module 203 A access rules, user management about 128 allow rule, creating 129 email domains, blocking 128 rules, checking 129 swear word, preventing 129 activity module about 140, 151 friends list 152 in action 151 permissions 151 public list 152 settings 153 address module about 182 administrators perspective 183 adresses, editing 182 adresses, storing 182 users perspective 182 APIs facebook 214 GMap 213 B back up, Drupal site 262 blog API, Drupal modules about 85 blog entry, posting from Microsoft Word 86 configuring 85 blogs, Drupal modules about 83 blog API 85 blog menu 84 using 85 viewing 84, 85 blog theme module about 135 configuration 135 themes, enabling 135 using 135 book, Drupal modules about 86 book pages, creating 88 collaborative book, creating 87 permissions 89 roles 89 C CAPTCHA module about 243 image test 244 math test 244 reCAPTCHA 245 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 [ 284 ] text test 245 clean URL 23 CMS 11-13 comments, Drupal modules about 74, 76 form 75 settings 74 within, Dino Space 76 communication, on individual basis communicating publicly 177 inactive users 176 Completely Automated Public Turing test to tell Computers and Humans Apart. See CAPTCHA module configuring Drupal 21, 22 configuring, WampServer about 280 GD2 module enabling, for PHP 280 rewrite module enabling, for Apache 281 contact module about 162 features 162 site-wide contact form 163 user contact form 162 content blocks about 183 creating, for anonymous users 184 content flags about 37 not promoted content 37, 38 not sticky content 37, 38 promoted content 37, 38 published content 37 sticky content 37, 38 unpublished content 37 content management, Drupal administration comments 46, 47 content 47 content types 49 post settings 50 RSS, publishing 50, 51 taxonomy 52 content management system. See CMS content types, Drupal about 189 creating 189 map, database 190, 191 new content types 189, 190 new content types, map 190 new content types, venue 191 venue, database 191, 192 contributed modules 73 contributed themes, Drupal about 220 installing 220 core modules. See Drupal modules cron, Drupal site maintenance 258 D default theme, customizing color scheme 221, 222 color scheme, color set preview 222 color scheme, custom color sets 222 global settings 225 logo image display 224 shortcut icon settings 224, 225 toggle display 223, 224 Dino Space network groups 169 downloading Drupal 15 WampServer 275 Drupal about 13 administering 39 APIs 213 as social networking platform 13, 14 content types 189 contributed themes 220 contributed themes, installing 220 default theme, customizing 221 downloading 15 installing 15-21 modules 187 modules, installing 241, 242 pre-installed themes 217 requirements 14, 15 roles 105 site, building 63 site, deploying 251 site, maintaining 258 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 [ 285 ] site, planning 61, 62 site, promoting 265 site, security 242 site backing up, with cPanel 261, 262 site restoring, within cPanel 263 themes, creating 225 themes and users 216 user management, administration 112 working 35 Drupal, configuring about 21, 22 actions 22 administration theme 23 alerts 30 clean URLs 23 date and time, settings 24 error reporting 24 file system 25 image toolkit 26 input formats 27-29 logs 29 performance settings 30, 31 site information 31, 32 site maintenance settings 32, 33 Drupal, working abstract framework 35 content flags 37 multi-user collaboration 38 nodes 36 terminology 39 Drupal 6 social networking 7, 8 Drupal administration content management 46 logging in 39 reports 60 sections 40 site, building 52 user management 41 Drupal modular system about 188 files, used 188 resources 188 Drupal modules about 73 aggregator 73 attachments 93 blog API 73, 85 blogs 73, 83 book 74, 86 comments 74 configuring 74 contributions 92 enabling 74 FeedAPI module 99 file upload 73, 93 forums 74 polls 74, 89 uploads 74 Drupal site about 72 backing up 261 backing up, with cPanel 262 building 63 communication, on individual basis 176 content blocks 183 deploying 251 groups, creating 169 groups, for Dino Space 169 mailing lists 177 maintaining 258 marketing materials 269 modules, installing 241, 242 monetizing 273 newsletters 269 planning 61, 62 profile, editing 125, 126 promoting 265 relationships,building between users 141 restoring, within cPanel 263 securing 243 security 242 social marketing 270 theme customizations, for communication 185 user activities 151 user activity, tracking 127, 128 user email settings 176 user roles 72 Drupal site, backing up with cPanel 262 Drupal site, building content, creating 66-69 taxonomy 63 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 [ 286 ] Drupal site, deploying database, setting up 254 database settings, changing 258 domain names 252 hosting 252 local database, importing 255 uploading 257, 258 uploading online 253 Drupal site, maintaining about 259, 260 cron 258 reports 260, 261 upgrading 260 Drupal site, planning content, grouping 62 static content 62 Drupal site, restoring within cPanel 263 Drupal themes about 215 and users 216 contributed themes 220 contributed themes, installing 220 creating 225 default theme, customizing 221 pre-installed themes 217 E error reporting 24 F facebook, APIs 214 feed aggregator, Drupal modules about 94 cron 98 feed, adding 96, 97 feed, viewing 98 feed category, adding 95, 96 menu 97 overview 94, 95 settings 95 FeedAPI module, Drupal modules about 99 configuring 100-102 downloading 99 enabling 100 installing 99 using 103, 104 fields, profile module about you, multi line text fields 123 about your dinosaur, free form list field 125 auto-complete 119, 122 breed, list selection field 124 category 119, 120 checkboxes 118 date field 118, 123 dinosaur’s date of birth, date field 124 dinosaur name, single line text fields 122 explanation 119, 121 form name 119, 120 free form list field 118, 124 list selection field 118, 124 location, single line text fields 123 mandatory 119 multi line text fields 118, 123 page title 119, 121 single line text fields 118, 122 title 119, 120 visibility 119-121 visible in user registration form 119, 122 web address field 118, 125 weight 119-122 file upload, Drupal modules about 92 general settings 93, 94 forums, Drupal modules about 76 container, creating 78 containers 77 creating 77, 79 forum topic, crearing 80, 81 managing 77, 80 permissions for users 83 planning 76 taxonomies 81-83 topics 77 G GD2 module 280 Globally Recognized Avatars. See Gravatar GMap, APIs 213 Google maps API API key, generating 192 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 [ 287 ] Gravatar about 110, 132 configuring 133 display preferences 134 integration, enabling 132 guestbook module about 155 display options 157 features 155 permissions 158 post settings 158 profile comments 155, 162 settings 155 site-wide guestbook 155, 159 site-wide guestbook, configuring 156 user guestbook 160, 161, 162 user guestbook settings 156 H HTML tags 27 HTML emails, mailing lists 180 I installing Drupal 15-21 modules 111, 139 WampServer 276-278 L LAMP 275 legal module 250 Linux, Apache, MySQL and PHP. See LAMP M Macintosh, Apache, MySQL and PHP. See MAMP mailing lists about 177 email, sending to all users 179, 180 HTML emails 180 legalities 180 third-party services 181 throttling 180 MAMP 275 marketing materials, Drupal site 269 messaging module 140 module files .info files 196 .info files, map module 196 .info files, venue module 196 .install files 207 .install files, map module 207-209 .install files, venue module 209, 210 .module files 196 .module files, map module 197-203 .module files, venue module 203 directories 195 locations 195 modules about 187 activity module 139, 140 address module 175 blog theme 111 contact module 140, 162 downloading 140 enabling 140, 141 extracting 140 Gravatars 111 guestbook 139, 155 installing 111, 139, 210, 211 map, creating 211, 212 messaging module 140 notifications module 140 OpenID 111 organic groups module 140, 169 profile 111 simplenews module 175 token module 140 tracker 111 user relationships 139, 141 venue, adding 212 views module 140 modules, creating content types 189 Google maps API 192 module files 195 new content types 189, 190 template files 193 mollom module 248, 249 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 [ 288 ] N newsletters, Drupal site 269 nodes 36 non core module. See FeedAPI module notifications module 140 O off-site SEO 273 on-site SEO links 272 meta tags 272 sitemap tools 272 up-to-date content 272 webmaster tools 272 online advertising, Drupal site about 265 advertisement networks, by search engines 267 advertising space buying, guidelines 266 newsletter advertising 268 Pay Per Click (PPC) advertisements 266, 267 Pay Per Click (PPC) advertisements, future 268 search engine penalization 268, 269 OpenID logging in, with 136, 137 user already exists 137 user does not exists 137 OpenID module 110, 136 organic groups module about 169 block, enabling 171, 172 configuring 169 group, creating 172, 173 group, using 173, 174 group content type, creating 170 page content type, configuring 171 P permissions 117 PHPList 181 polls, Drupal modules about 89 creating 90 roles 92 pre-installed themes, Drupal bluemarine 217 chameleon 218 garland 218, 219 marvin 219 minnelli 219 pushbutton 220 profile module about 118 fields 118 fields, adding to site 118 overview 119 user profile, extending 119 R reCAPTCHA about 245 API key signing up for 246 private keys entering 246 public keys entering 246 reCAPTCHA PHP library, downloading 245 relationships, Drupal site building, between users 141 creating 142 default relationship 148 my relationships page 150 permissions 147 planning 141 relationship, creating with other user 148, 149 settings 145 reports, Drupal administation access denied, errors 60 available updates 60 final status report 61 page not found, errors 60 recent log entries 60 rewrite module 281 roles about 105, 117 additonal roles, creating 106 anonymous role permissions 105, 117 anonymous user roles 105, 117 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 [ 289 ] authenticated user roles 105, 117 authenticated users 105 contributors 106 editing 117 moderators 106 permissions, altering 105 power contributors 106 S Search Engine Optimization. See SEO security, Drupal site about 242 announcements 242 CAPTCHA, image test 244 CAPTCHA, math test 244 CAPTCHA, setting up 247, 248 CAPTCHA, text test 245 Completely Automated Public Turing test to tell Computers and Humans Apart (CAPTCHA) module 243 legal 250 mollom 248, 249 passwords 251 reCAPTCHA 245 reCAPTCHA, API key signing up for 246 reCAPTCHA, private keys entering 246 reCAPTCHA, public keys entering 246 reCAPTCHA PHP library, downloading 245 SEO off-site SEO 273 on-site SEO 271, 272 settings, user relationships module elaborations 146 email notifications 146 general settings 145 messages 146 simplenews module about 175 working 177 site, monetizing 273 site-wide contact form, contact module about 163 contact form categories, creating 164 contact link 168 differences, with per-user contact form 168 enabling, in menu 167 information, adding to form 167 module, configuring 164 site building, Drupal administation blocks 53, 54 menus 55 modules 58, 59 new menu item, creating 56, 57 themes 59 social marketing, Drupal site about 270 social bookmarking 271 twitter 270 viral marketing 270 social networking about 7-9 creating, need for 9, 10 DinoSpace! web site, creating 11 site, FriendFeed 9 site, Twitter 9 social networking, need for to enable communication 10 to improve business 10 to provide a service 10, 11 T taxonomy new vocabulary, creating 66 tags, creating for vocabulary 65 terms, creating for vocabulary 65 vocabulary, creating 63, 64, 65 template files node-map.tpl.php 193, 194 node-venue.php 194, 195 theme, creating info file 226, 233 logo 227, 239 other files 227 screenshot 227, 239 starting 228-233 template.php file XE 227 template files 227, 234 template files, page.tpl.php 234-238 theme structure 226 theme, Drupal contributed themes 220 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 [ 290 ] creating 225 default theme, customizing 221 pre-installed themes 217 theme customizations, Drupal site examples 185 used, for communicating with users 185 theme structure info file 226 logo 227 screenshot 227 template.php 227 template files 227 third-party mailing lists constant contact 181 Google-groups 182 PHPList 181 token module 140 tracker module 111 U user activities, Drupal site about 151 friends list 152 permissions 151 public list 152 settings 153-155 user management, Drupal administration access rules 41, 42, 112, 128 Gravatar 112 permissions 42, 43, 117 profiles 112 roles 43, 44, 117 users 45, 112 user settings 44, 112, 130 user relationships module about 141 permissions 147 planning 141, 142 relationships, creating 142-144 settings 145 user roles 72 users, Drupal administration about 112 creating 114 filtering 113 searching 113 sorting 113 user, blocking 116 user, deleting 116 user account, editing 115 viewing 113 user settings, user management about 130 picture settings 132 user email settings 131 user registration settings 130, 131 V views module 140 W WampServer configuring 280 downloading 275 installing 276-278 overview 279 This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Thank you for buying Drupal 6 Social Networking Packt Open Source Project Royalties When we sell a book written on an Open Source project, we pay a royalty directly to that project. Therefore by purchasing Drupal 6 Social Networking, Packt will have given some of the money received to the Drupal project. In the long term, we see ourselves and you—customers and readers of our books—as part of the Open Source ecosystem, providing sustainable revenue for the projects we publish on. Our aim at Packt is to establish publishing royalties as an essential part of the service and support a business model that sustains Open Source. If you're working with an Open Source project that you would like us to publish on, and subsequently pay royalties to, please get in touch with us. Writing for Packt We welcome all inquiries from people who are interested in authoring. Book proposals should be sent to author@packtpub.com. If your book idea is still at an early stage and you would like to discuss it first before writing a formal book proposal, contact us; one of our commissioning editors will get in touch with you. We're not just looking for published authors; if you have strong technical skills but no writing experience, our experienced editors can help you develop a writing career, or simply get some additional reward for your expertise. About Packt Publishing Packt, pronounced 'packed', published its first book "Mastering phpMyAdmin for Effective MySQL Management" in April 2004 and subsequently continued to specialize in publishing highly focused books on specific technologies and solutions. Our books and publications share the experiences of your fellow IT professionals in adapting and customizing today's systems, applications, and frameworks. Our solution-based books give you the knowledge and power to customize the software and technologies you're using to get the job done. Packt books are more specific and less general than the IT books you have seen in the past. Our unique business model allows us to bring you more focused information, giving you more of what you need to know, and less of what you don't. Packt is a modern, yet unique publishing company, which focuses on producing quality, cutting-edge books for communities of developers, administrators, and newbies alike. For more information, please visit our website: www.PacktPub.com. This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Building Powerful and Robust Websites with Drupal 6 ISBN: 978-1-847192-97-4 Paperback: 362 pages Build your own professional blog, forum, portal or community website with Drupal 6 1. Set up, configure, and deploy Drupal 6 2. Harness Drupal's world-class Content Management System 3. Design and implement your website’s look and feel 4. Easily add exciting and powerful features 5. Promote, manage, and maintain your live website Elgg Social Networking ISBN: 978-1-847192-80-6 Paperback: 179 pages Create and manage your own social network site using this free open-source tool 1. Create your own customized community site 2. Manage users, invite friends, start groups and blogs 3. Host content: photos, videos, MP3s, podcasts 4. Manage your Elgg site, protect it from spam 5. Written on Elgg version 0.9 Please check www.PacktPub.com for information on our titles This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801 Learning Drupal 6 Module Development ISBN: 978-1-847194-44-2 Paperback: 310 pages A practical tutorial for creating your first Drupal 6 modules with PHP 1. Specifically written for Drupal 6 development 2. Program your own Drupal modules 3. No experience of Drupal development required 4. Know Drupal 5? Learn what's new in Drupal 6 5. Integrate AJAX functionality with the jQuery library 6. Packt donates a percentage of every book sold to the Drupal foundation Drupal 6 Themes ISBN: 978-1-847195-66-1 Paperback: 291 pages Create new themes for your Drupal 6 site with clean layout and powerful CSS styling 1. Learn to create new Drupal 6 themes 2. No experience of Drupal theming required 3. Techniques and tools for creating and modifying themess 4. A complete guide to the system's themable elements Please check www.PacktPub.com for information on our titles This material is copyright and is licensed for the sole use by Richard Ostheimer on 15th June 2009 2205 hilda ave., , missoula, , 59801

Drupal 6 Social Networking

zhongxc1

贡献于2014-08-05

Login

Block

Welcome to Dino Space!

What is Dino Space?

Login

相关文档