Welcome to Dark Matter Pro

Table of Contents

Introduction

Dark Matter Pro is a template for Pixelpost. In fact it's quite a bit more than just a template because it adds a lot of new functionality to Pixelpost not present in the default version. Dark Matter Pro is the result of over three months of hard work. Choosing for Pixelpost combined with Dark Matter Pro means choosing for the world's most advanced photoblog solution.

Dark Matter Pro was made with the highest possible quality standards in mind. This means clean and valid XHTML output, rock solid YUI powered Javascript, degradability and excellent accessibility. You will not find a more polished photoblog product than Dark Matter Pro.

Dark Matter Pro features a color neutral design that gets completely out of the way of what really matters: YOUR photography. By choosing Dark Matter Pro you are giving your hard work the ultimate online presentation platform.

Dark Matter Pro was created by Marco van Hylckama Vlieg, a seasoned web developer with a strong passion for photography. You can see his photography presented with Dark Matter Pro on his personal photoblog.

Basic Installation

Installing Dark Matter Pro is easy if you stick to the following easy steps:

  1. Upload addons/dm_support.php and addons/admin_darkmatter.php to your pixelpost addons directory. Upload the entire darkmatter directory to your pixelpost templates directory.
  2. Enable the addon named Dark Matter Pro Configuration
  3. Choose Dark-Matter in your pixelpost administration panel. This will show you the Dark Matter Pro administration panel and initialize the settings table. Don't change anything yet.
  4. Go back to your Addons panel and enable the Dark Matter Pro support addon
  5. Go to Options -> Thumbnails and make sure that the setting THUMBNAILROW is set to a value of 5. This is the default for Pixelpost.
  6. In this same panel, make SURE the thumbnails have a width of exactly 100 pixels. You can choose any height you want but the width MUST be 100 pixels. Make sure you hit Re-generate thumbs after you've changed the width and/or height. Note that Pixelpost's default is 100x75 which is fine to use with Dark Matter. If it's already set to 100x75 you can go to the next step unless you want to change the height.
  7. Make sure the Page-By-Page-Archive for category and month addon is ENABLED. This addon comes with Pixelpost.
  8. Go to Options -> Template and pick darkmatter under 'SWITCH TEMPLATE'. Hit UPDATE
  9. Congratulations, you're now running Dark Matter Pro. You can now tweak settings in Options -> Dark-Matter in your Pixelpost administration panel. Make sure you read the guidelines on image sizes. If you want to make use of the extras, read the extras section.

« Back to table of contents

Internationalization

If you want to use Dark Matter Pro in another language than English, please edit the file i18n.php inside the darkmatter directory. This file contains ALL strings used in Dark Matter Pro and is therefore the only file you'll have to modify in order to translate Dark Matter Pro.

« Back to table of contents

Varying page widths and image sizes

Dark Matter Pro allows you to pick your own desired page width between 700 and 950 pixels, in intervals of 50 pixels. You can choose whatever you like best!

For an optimal viewing experience for your visitors, Dark Matter Pro looks best when your uploaded photos have the same width you've chosen to use as your page width. Less wide images will work but you'll see black borders on the left and right side. Larger images will be cropped on the right side. Therefore never use images wider than the page width you've chosen to use.

« Back to table of contents

Other customizations

Page logo

You can change the page logo with ease by uploading a file in the Dark Matter administration panel. This file may be a jpg, a gif or a png. The image needs to be exactly 28 pixels in height. You can pick any width you want but be advised: The wider the logo, the less space is left in the header for your site title and the menu section.

There is a separate upload for Internet Explorer 6. You ONLY need to use this if your main logo is a 24bit PNG file with alpha transparency. This is because the won't work correctly in IE6 resulting in a strange looking logo. You can use this upload box to upload an alternative logo for IE6 in gif, jpg or 8 bit PNG format. For both logo uploads: make sure you don't forget to tick the checkbox. When the checkbox is not checked the default logo will be used.

Page background

Though not recommended, the option to change the page background color is provided. Enter a value in 3 or six digit RGB hex format preceded by a hash. (e.g. #000 or #000000 for black and #fff or #ffffff for white). This page background will be used in both the dark and light version! Leaving this box empty will revert to the original background.

About page

By default, the about page is empty. You can add content to this page by opening the file named about_template.html in a text editor and add content to it. You will find markers labeled <!-- start editing here --> and <!-- stop editing here -->. You can add any HTML markup between these two markers. When you're done, upload your modified about_template.html to the dark matter directory on your server and you're good to go.

« Back to table of contents

Extra addon support

Dark Matter supports various add-ons out of the box. Others need some modifications which have been done for you. Various add-ons that work well with Dark Matter have been provided in the extra directory in the archive you downloaded.

The most noteworthy one is RGB Histograms which creates a nice color histogram for your images. A special place is reserved for it in Dark Matter's image info pane. To install it follow these steps:

  1. Upload extra/admin_RGBhistogram.php into your pixelpost addons directory
  2. Create a new directory named histograms in your pixelpost directory and make sure it's writable by your webserver. If you don't want RGB histograms you can skip this step and the next step and disable histograms in the Dark Matter options panel
  3. Enable the RGB Histograms add on. A new option named RGB-Histogram will appear in your pixelpost administration panel. Choose this option and generate histograms. IMPORTANT: leave all settings on their default value except for the background color. Choose #000000 if you use the dark theme and choose #ffffff if you use the light theme.!
  4. Go to the Dark Matter options panel and check the Histograms checkbox. RGB histograms will now appear in your image info panes.

A few other noteworthy addons are distributed with Dark Matter in a pre-modified form to work well with Dark Matter. They are:

  • AJAX ratings
  • PayPal (allows you to sell your images and get paid on PayPal)
  • dfGallery (a Flash slideshow viewer)
  • SoloIT (nice addon that allows people to 'switch off the light' and hide everything on the page except the viewed photo)

The template tags needed for these addons to work have been placed in image_loaded.php If you only want some of the above add-ons you can use it to find where to place the template tags. If you want all of them you can remove image_template.php and rename image_loaded.php to image_template.php in your darkmatter directory.

For dfGallery a pre-made template is provided. It's name is slideshow_template.html. You'll have to install and configure the dfGallery addon according to the instructions provided with it but can then skip the part where you have to create a new template and add a tag. After installing dfGallery your slideshow will be available at http://www.yoursite.com/index.php?x=slideshow. Make sure you add this link to the menu in all templates. Look for <ul id="menu"> to find it in your templates.

All modified extra add-ons are provided in the hope they will be useful for some of you on an as-is basis. I can not provide support on how to use them.

SoloIT and AJAX Ratings come with some Dark Matter Pro specific instructions. The PayPal addon can just be uploaded to your addons directory and enabled in your Pixelpost admin panel and it will work. Again you'll find the appropriate tag to use and where to put it in the image_loaded.php template.

« Back to table of contents

Troubleshooting

Before anything else, please double check that the following checklist applies to your installation. Most common problems are related to one of these steps not being completed!

  1. The Dark Matter Support addon is uploaded to your addons folder and enabled (dm_support.php)
  2. The Dark Matter Admin addon is uploaded to your addons folder and enabled (admin_darkmatter.php)
  3. The Page-By-Page-Archive for category and month addon is enabled
  4. The entire darkmatter folder has been uploaded to the templates folder in your pixelpost install

If you need help with Dark Matter you can email me. However you're probably going to get help faster if you try the Pixelpost forum. I read this forum daily. If you ask your question there you may get an answer from a fellow user before I even see it and other users may benefit from your question and the answer.

If you think you've found a bug in Dark Matter Pro, please make sure you:

  • Can properly reproduce the bug
  • Provide a detailed description of the problem
  • Provide information about the browser and operating system you are using

I cannot respond with proper action to incomplete or vague bug reports.

« Back to table of contents

Dark Matter Pro Disclaimer & License Agreement

I'm not a lawyer which is why I won't bother you with endless unreadable license agreements. From hereon, I, Marco van Hylckama Vlieg will be referred to as 'the author'. It all boils down to the following:

By purchasing a license for Dark Matter Pro you agree to the following terms:

  • Your license allows you to use Dark Matter on ONE DOMAIN, unless you purchased a site license or a developer license.
  • Your license entitles you to free 1.x updates / bugfix releases. You will be informed about these by email.
  • You are not allowed to (re)distribute Dark Matter Pro or parts of Dark Matter Pro in ANY form.
  • You are not allowed to merge ANY aspects of Dark Matter Pro into Dark Matter Free edition and (re)distribute this modified version of Dark Matter Free edition.
  • The author will actively maintain Dark Matter Pro and fix issues as they are reported the best he can and as quickly as he can. There is however NO OBLIGATION for him to do so and NO OBLIGATION to do this within a fixed amount of time. In other words: the template is provided 'as-is'.
  • Dark Matter is offered as a template for Pixelpost 1.7.1. Any other versions may or may not work with Dark Matter Pro but are NOT OFFICIALLY SUPPORTED.
  • The author is not liable for any kind of damage including loss of data caused by using Dark Matter Pro.
  • While the author will try to do the best he can to provide support in case you have problems, YOU are ultimately responsible for installing Dark Matter Pro on your hosting environment and getting it to run properly UNLESS you hire him to do it for you.
  • The author will not refund any payments made.
  • The author reserves the right to update / modify these terms at any time.

« Back to table of contents