Please note that this is an old version of drigg and is only for those who want to test.

Drigg can be seen running live over at http://www.fsdaily.com/

Drigg can be installed in two ways.

The first one is the "express way" - a "Drupal distribution" offered here from drigg.org which includes a working copy of Drupal and a basic database schema that will give you a pre-configured site.

Or, you can do it yourself. Doing it yourself is not actually much more complicated. You will still need to configure your web server properly. You may still have to refer to Drupal's official documentation if you have any installation problems.

What about upgrading?

If you are already using Drigg, and would like to upgrade, all you need to do is download new versions of Simple Karma and Drigg:

Simple Karma
Drigg

If a new version of Drupal is out, the "express way" (below) will definitely use it. If a MAJOR new version of Drupal came out, it might take a while for the two modules to catch up.

Detailed upgrading information are in the UPGRADE.txt file in any Drupal package.

Drigg - the "express" way [Drupal 5.3]

Installing Drupal this way is a little easier. It's basically a Drupal installation where every single step described in the "manual way" has already been carried out.

NOTE: The "express" way is also the ONLY way available right now. It uses the development snapshots, since the Drigg module hasn't been released and finalised yet!

Step 1: Install Drupal

Please follow the instructions in the next section "Drigg - the manual way" - but only Step 1, and using Drigg Drupal.

Please remember to change the file [your_drupal_dir]/sites/defauly/settings.php so that it contains your database information.

Step 2: Load information into your database

Now, load the database dump [your_drupal_dir]/drigg/drigg_distr_sql.mysql into your drupal database. You can do this from the command line by typing (assuming that the database name is drigg_db):



Important note: the main user's name is "admin", the password is "adminhere". You NEED to change this as soon as you log in.
There is also another user: "admin user". The password, again, is "adminhere".

Step 3: Customise it!

At this point, you will want to change some of the information that comes "in stock" with this prepackaged version:

* Username, email addresses and passwords for the users "admin" and "admin user". Go to Administer -> Users
* The "site's" email address. Go to Administer -> Site information
* Your Google pub-id. You can change it by editing [your_drupal_dir]/sites/all/themes/zen_for_drigg/template.php, where it says $vars['ad_id']="pub-00000000000000000"; If you don't want Google ads, you can edit the templates (they are all in [your_drupal_dir]/sites/all/themes. Keep in mind that the current templates ensure that users with the permission "drigg ad free site" won't see ads.

Step 4: That's it!

You might want to go through the step below, so that you know what the step would have been if you hadn't been lazy.

Drigg - the manual way

Step 1: Install Drupal

Installing Drupal is the biggest favour you can do to yourself if you want to run a web site.
The latest version of Drupal available is 5.3.
You can get it here: http://ftp.drupal.org/files/projects/drupal-5.3.tar.gz
(Please check http://www.drupal.org if the link above is indeed the latest version of Drupal!)

If you don't have access to your server, contact your provider and ask if they have Drupal available as an optional piece of software.

Go through the normal installation procdure (the file "INSTALL.txt"), including the creation of the admin account and the setup of cron tasks.

Important note: for Drigg to work, you need to:

* Install Drupal in your server root. So, Drupal needs to be your home page. We are trying to overcome this problem. However, for now this limitation exists.
* Enable "Clean URLs". This means that Drupal will allow pages like this: http://www.localhost.com/admin rather than http://www.localhost.com?p=admin. Again, this limitation does have workarounds. But, this is how it is right now. You can do it by Administer -> Clean URLs.

Step 2: Install the required modules Drigg depends on

It's much better to install extra modules in the directory [your_drupal_dir]/sites/all/modules. This will keep your core drupal installation completely "clean".

Simple Karma

The module simple_karma is the heart of Drigg. Installing it properly is absolutely crucial.

* Uncompress it into your modules directory
* Go do Administration -> Modules and check Simple Karma's check boxes
* Click "Save configuration"

Again, you won't need to configure it - the module's default will do absolutely fine.

Drigg

This is the "actual" Drigg module.

* Uncompress it into your modules directory
* Go do Administration -> Modules and check Drigg's check boxes
* Click "Save configuration"

Tagadelic

Well, this is not strictly required by Drigg. However, I can promise you that you'll like it and will want to use it!
It's the same story:

* Uncompress it into your modules directory
* Go do Administration -> Modules and check "Tagadelic"'s check boxes
* Click "Save configuration"

Captcha

Well, this is not strictly required by Drigg. However, I can promise you that you'll like it and will want to use it!
It's the same story:

* Uncompress it into your modules directory
* Go do Administration -> Modules and check "Captcha"'s check boxes (also for Captcha images and text)
* Click "Save configuration"

Step 2a: Create two categories

It's now time to create two important "dictionaries": one to hold the scoops' categories, and one to hold the scoops' tags. So:

* Go to Administration -> Categories
* Click on "Add vocabulary"
* Fill out the form: Vocabulary Name should be "Category", Types should be "Scoop", "Required" should be checked.
* You can see the list of categories now, which includes "Category". Click on "Add terms"
* Add at least a couple of terms. Don't worry: these categories are not final.

Now, repeat the same thing for the tags:

* Click on "Add vocabulary"
* Fill out the form: Vocabulary Name should be "Tags", Types should be "Scoop", "Free tagging" and "Required" should be checked.

Done!

IMPORTANT NOTE:You will need to "reconfigure" the Drigg module every time you add a category. This means going to Administer -> Drigg and hitting the "Save settings" button. This is important: Drigg creates an internal cached version of the categories, and needs to be "told" that new categories are available. So, you must go to the Drigg configuration screen if you add categories here (see below how to do that)

Step 3: Configuring the modules

You will now need to configure Simple_karma and Drigg in order for them to suit your needs.
Their configuration interfaces are here:

* Administer -> Simple Karma (Simple Karma's administration). IMPORTANT: tick the checkbox "Scoop" in the section "Node types that will accept karma:"
* Administer -> Drigg module. Again, don't despair. The defaults are likely to do just fine. Please note that the first two select boxes should contain "Section" and "Tags" respectively. Those are the categories you just created.
* Administer -> Drigg - look&feel (Change the way some of Drigg's elements look). You probably won't change these at this stage. However, it's important to know where these are.
* Administer -> Drigg - embedded objects management (Configure how embedded objects are treated). You probably won't change these at this stage. However, it's important to know where these are.

You need to click on "Save configuration" in every single screen here. This will set some "good defaults" for the modules to work with.

Finally, go here: Administer -> Content Types -> Drigg and untick "Promoted to front page" in the list of the default options.

Step 3: Configuring the modules' access

You will also need to configure access to these modules, in order to decide which user can do what. Standard Drupal has two types of users: "anonymous" and "logged in".

So:

* Go to Administration -> Access Control
* In the "drigg module" section, grant "submit drigg stories" access to authenticated users; grant "view drigg stories" to both anonymous and authenticted users
* In the "simple_karma module" section, grant "give karma" access to authenticated users
* In the "comment module" section, grant "access comments" access to anonymous users

comment module

The drigg and the simple_karma modules also give you other permissions. However, it requires some (basic) Drupal knowledge to know about those ones.For now, you can ignore them.

Step 3a: Turn Drigg into your site's home page

This is probably what you will want to do. So, go to Administer -> Site Information and change the default front page from "node" to "drigg_home". This is also a good time to set the Email address.for your Drupal installation

Step 3b: Add the Zen-derived default theme

Drigg needs the theme to do a few very important things:

* Call print simple_karma_template_forms(); in page.tpl.php. This is needed to the Javascript
* Call print theme_drigg_sections(); in page.tpl.php. This will print out the sections defined as a clickable menu.
* Call print drigg_get_submit_button(); somewhere in page.tpl.php. Well, this is not necessary, but it's definitely nice!
* Have a page-drigg.tpl.php defined. This file will define what a scoop will look like.

The easiest way to go about the theme is to just use the default theme file that comes with Drigg. In the drigg directory (located under [your_server]/modules/drigg, you will find two files:

* zen
* zen_for_drigg

Move or copy these two directories in the "themes" directory in your server located in [your_drupal_dir]/sites/all/themes

After entering the themes/ directory, you can compare the two themes by running diff -r zen zen_for_drigg and see the (few) differences between the two themes.

You now need to enable the theme. go to Administer-> Themes, and pick "Zen for Drigg". The layout of your site will change dramatically. Now, your scoops will look right.

Step 3c: Extra small step to configure Drupal right

Go to Administer -> Themes, hit the "Configure" tab, and uncheck "Scoop" in "Display post information on".
Step 3d: Keep your customisations safe

At this point, you are using [your_dupal_dir]/sites/all/modules/simple_karma/simple_karma_[non]_js.css as your CSS file, and the images in [your_dupal_dir]/sites/all/modules/simple_karma/simple_karma_[images] as your image files. If you change them, and then upgrade the simple_karma module, you will lose your customisations!

A much better way to go about it is to copy:

1. simple_karma_*.css
2. simple_karma_images

Into your theme folder. In this case: [your_drupal_dir]/sites/all/themes/zen_for_drigg/.

You also need to tell simple_karma about the location of the new directory. You can do that by going to Administer -> Simple Karma, and typing sites/all/themes/zen_for_drigg in the first configuration option "CSS files director".

This will make sure that your css file will be preserved when (not if, when) you will upgrade to a newer version of Simple Karma.

Step 4: Play with the system!

It is now time to submit a couple of stories (Create Contents -> Scoop), and make sure that everything is OK. Voting should work. Try to create a couple of extra users, test their votes, and so on.
You will notice that nodes have
Step 4a: Create an "admin user" and give it extra powers

Now that you've played with the system, it's time to create a "special" user.

Go Administer -> Roles and create a "karma admin" role.

Now create a new user: "admin user" from Administer -> Users -> Add User. Make sure you assign the user the "karma admin" role.

Finally, go to Administer -> Access Control. From there, under "simple_karma" and "drigg", you will be able to assign extra powers to all the users with the role "karma admin" attached to them.

Step 5: Add blocks

At this point, you should have some testing nodes. You can now add some blocks. Go to Administer -> Blocks. There are five blocks you can have:

* Best karma users
* Best karma nodes
* Best karma comments
* Top upcoming in current category
* Top published in current category
* Drigg categories
* Tags in tags (You can rename this block's title from its configuration)

The interface to add blocks is very simple: play with it, remembering that you need to have some fake stories and comments in order to actually have something to see!

Remember that by default stories in the blocks don't show the karma amounts. However, you might want to enable it: you can do so on a per-block basis by clicking on "configure" in each block.

Step 4c: An extra touch

Since you are using the drigg_zen theme, you might as well use some of its pretty images!
Go to Administer -> Drigg - look&feel.

In "Feed string for feeds pointing to all articles", add



In "Feed string for feeds pointing to promoted articles", add



In "String to show next to the username if the user voted the story UP", add



In String to show next to the username if the user voted the story DOWN, add



Step 5: Nice aliases

While playing with the system, you must have noticed that stories are referred to as /node/3 or /node/5 etc. This is less than optimal. In order to have URLs like /Category/The_articles_title_more_or_less, you will need to:

* Open the file [your_server]/modules/drigg/custom_url_rewrite_function.php. This file came with the drigg module.
* Select all of the text and copy it to the clipboard (all of it, from function custom_url_rewrite($op, $result, $path, $path_language=NULL) to the end of the file
* Paste it right at the end of your settings.php file, which is probably located in sites/default/settings.php
* That's it!

Reload a page, and notice that the URLs have drastically changed.
IMPORTANT NOTE: You absolutely have to save the Drigg configuration if you add more categories.

Step 6: More aliases

The current link to add a scoop is the Drupal-looking add/node/scoop. Yuck! Do this:

* Go to Administer -> URL Aliases
* Click on "Add alias"
* In "Existing system path", type "node/add/drigg". Underneath, type "submit"

Done. If you see other URLs you don't like, you can change them in the same way.

Step 7: Enjoy your site!

Well, that's it. It was a lot of work, but it was definitely worth it!

Download The Drigg Test Package Install


Hompage
http://www.drigg-code.org

Is Drigg coded better than Pligg?

Pligg has some major coding issues.

Geoserv.

The latest version of drigg is pretty awesome and very feature rich, plus the fact it's based on the drupal CMS system gives you many options to build a great community including a vast array of social network features like connections, forums etc.

The only thing missing from drigg at the moment are dynamic external vote buttons like the Digg button, but everything else and a lot more is present.

follow our WAMP Server tutorial here then you can grab a copy of drigg and test it out..
http://socialcmsbuzz.com/run-wamp-as-a- ... -20022008/

Personally i like to install the latest version fo drupal then get the latest version of the drigg module from below instead of usuing the all in one pack which can be out of date due to regular updates.

http://drupal.org/project/drigg

hi Lincoln have you been able to get any image upload module to work with drigg that will upload and display an image iline within drigg posts at the moment they say we will have to wait untill 6x is avlible but i was wondering if you had found a work around thanks rod

Hi roddy,

unfortunately i haven't really worked with drigg a whole lot yet, tony is doing some large updates at the moment to the drigg system and has placed a halt on feature requests for now. Once the updates are all completed we will be making a few free templates for drigg as well as hopefully contributing some code.

Sorry i cant be of help to you at the moment m8

Best

Lincoln

thanks for the swift replly i am now working on the image isue and iam nearlly there just one litle bug if i get it sorted ill make a post

Ok... I let down Pligg because tags and categorys don't works with french accents.

To use Drigg in the same way, shoult I just translate the drigg-theme in /sites/all/themes/drigg_theme ?

Can I help in translating to french anything ?

Best regards...

Hi pierre,

Unfortunately i only know english so would be of no help at all translating to french, sorry

I'm hoping to start a site soon with this software! Is the project still on freeze?

yeah m8 think it is, shoulddn't be long now till the freeze is lifted though and the current version available from the drupal site works 100% fine if your gonna set up a development site or testing etc.