EXT: Photo Blog¶

What does it do?¶

A blog geared towards posting of images. You can find other examples of photoblogs on http://photoblogs.org . You might find an exampe here: http://teknowlogic.org/index.php?id=photoblog

Compatibility¶

Where did my categories go?

When upgrading from pre 0.2.8 versions, you may experience 'disappeared category titles'. Please use the UPDATE tool in the photoblog extension manager.

Photoblog version greater than 0.2.7 make use of 'nested categories'. This feature makes use of existing functions which appear to have been written for the 'pages' table. The point is that these functions expect a 'title' field in the category table which I did not use. So the update tool makes all things work again.

What's up with the sorting order of my images? In the later incarnations of photoblog, the sorting is exclusively done by the photodatetime field. This used to be crdate. You can copy the crdate column over to the new photoblogdatetime function. Only empty photodatetime values will be filled with the crdate value. This means that the dates you have already entered by hand will not be touched.

Screenshots¶

Installation¶

Install the extension with the extension manager.

Create a sysfolder to store the blog entries¶

Create a new page of type 'sysfolder'. This will be the page where we will store all the blog entries, categories and comments.

This is the complete tree structure I use:

Create a page containing the blog plugin¶

• Create a new page for the photoblog plugin.
• If you are using a version prior to 0.2.9; Disable caching for the page!
• Insert the plugin by choosing 'Create page content' and selecting 'PhotoBlog' from the plugin list.
• Choose what to display. You could start out with 'BLOG'.
• Choose a startingpoint. This will probably be the sysfolder you just created.
• You need to specify a template. If you don't, nothing will show up in the frontend. You can specify your own template under the 'template tab'. It is however easier to load the static data from the photoblog plugin. The static data will also set some sensible defaults for image width, maximum number of images and so on. You can also load a default style sheet in this way. Please read the section titled Configuration to see how to include the static data.

Create a category (optional)¶

Go to the photoblog sysfolder and create a new record of type 'Photoblog category'.

To make sure you can select your newly created category when creating a new blog entry, you have to set the general record storage option of the sysfolder to itself. If you don't, then we don't know where to find the categories.

I could make a configuration option to create a seperate folder to store just the categories and another folder to store all the comments. This might be a good thing. It also might scare people away because of 'too many config options'.

Setting up some sensible defaults¶

I recoomend to use the inclusion of static data as described below. The big advantage here is that you load a set of sensible defaults. If you don't like the default settings, tweak them using the 'flexforms'.

When the static data is added to the template, you can edit most of the configuration settings using the template constant editor. Editing the constants in this way has the advantage that they will be set for all the pages. This means that you can set all your settings using the constant editor and skip most of the flexform configuration. This is convenient when you have a lot of pages using the photoblog plugin.

Create a blog entry¶

• Go to the photoblog sysfolder and crea a new record of type 'Photoblog photo'.
• Choose a title, image, category and description.
• Check out the page in the frontend.

Comments¶

For comments to work, you will need a page to display the comments. Create a new page with the photoblog plugin and set the 'what to display' to 'COMMENTS'. Choose the maximum photo width for the comment page and also choose the Startingpoint (This should be the same location as where the blog entries are stored).

Now that you have created the comment page, go to your blog page. On the blog page you can now select the page you just created to be the comment page.

If you did all this correctly, a comment link will magically show up on the blog page.

Comment moderation¶

Comment moderation can be enabled on the 'advanced' tab. When you enable comment moderation, all submitted comments will be set to 'hidden'. An email will be sent to a moderator who may 'unhide'/approve the comment by clicking a link. You can select a list of frontend users as moderators. Round robin scheduling is used to send out the emails to the moderators.

IMPORTANT!

Make sure you enter your moderation preferences on the 'comment' page.

A moderation email:

RSS feed¶

To enable the XML-feed, add the static ext-template “Photoblog (RSS, RDF, Atom03)” to your TypoScript setup. This adds a new page-type (1000) and configures photoblog with the code “RSS”, if a page with type=1000 is requested. The other settings for RSS feeds can be configured in the constant editor or directly in your TypoScript setup (see reference). Take note that you need to set at least pid_list and blogPid globally (using the constant editor or TS) in order for the feed to work.

The feed you have chosen will now be available under http://your.site.org?type=1000

RealURL configuration¶

It is possible to make your site generate nice urls using the excellent realurl extension. Below is a configuration example for use with realurl. If you have realurl installed, you will know what to do with this snippet. If you don't, install realurl and read the docs.

'postVarSets' => array (
  '_DEFAULT' => array (
    'photo' => array (
      '0' => array (
        'GETvar' => 'tx_photoblog_pi1[showUid]',
        'lookUpTable' => array (
          'table' => 'tx_photoblog_photo',
          'id_field' => 'uid',
          'alias_field' => 'title',
          'addWhereClause' => ' AND NOT deleted AND NOT hidden',
          'useUniqueCache' => '1',
          'useUniqueCache_conf' => array (
            'strtolower' => '1',
            'spaceCharacter' => '-',
          ),
        ),
      ),
    ),
    'category-thumbs' => array (
      '0' => array (
        'GETvar' => 'tx_photoblog_pi1[showCatUid]',
        'lookUpTable' => array (
          'table' => 'tx_photoblog_category',
          'id_field' => 'uid',
          'alias_field' => 'title',
          'addWhereClause' => ' AND NOT deleted AND NOT hidden',
          'useUniqueCache' => '1',
          'useUniqueCache_conf' => array (
            'strtolower' => '1',
            'spaceCharacter' => '-',
          ),
        ),
      ),
    ),
    'link-to-previous' => array (
      '0' => array (
        'GETvar' => 'tx_photoblog_pi1[linkToPreviousEntry]',
      ),
    ),
  ),
),

((generated))¶

0.2.19 (BETA)¶

0.2.14 (BETA)¶

0.2.13 (BETA)¶

0.2.12 (BETA)¶

0.2.11 (BETA)¶

0.2.10 (BETA)¶

0.2.9 (BETA)¶

0.2.8 (BETA)¶

0.2.4 (BETA)¶

0.1.7 (BETA)¶

0.1.6 (BETA)¶

0.1.5 (BETA)¶

0.1.0 (BETA)¶

0.0.14 (ALPHA)¶

0.0.12 (ALPHA)¶

0.0.10 (ALPHA)¶

0.0.7 (ALPHA)¶

0.0.3 (ALPHA)¶

EXT: Photo Blog - 17