DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

websiteportfolio

Author:Michiel Roos
Created:2006-09-07T20:27:13
Changed by:Michiel Roos
Changed:2006-09-10T12:19:19
Author:Michiel Roos [netcreators]
Email:extensions@netcreators.com
Info 3:
Info 4:

websiteportfolio

Extension Key: websiteportfolio

Copyright 2000-2002, Michiel Roos [netcreators], <extensions@netcreators.com>

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

- a GNU/GPL CMS/Framework available from www.typo3.com

Table of Contents

websiteportfolio 1

Introduction 1

What does it do? 1

Screenshots 2

Users manual 5

Installation 5

Create a sysfolder to store the portfolio and category entries 5

Create a page containing the portfolio plugin 5

Create a category (optional) 5

Create a webstie entry 5

Adminstration 5

Configuration 5

Tutorial 6

Known problems 6

To-Do list 6

Changelog 6

Introduction

What does it do?

Display a portfolio of websites you have created. Each site has an image, description, used techniques and links. You might find and example over here: http://teknowlogic.org/foliage/

Features
  • Post portfolio entries.
  • Display a list of thumbnails of the screenshots.
  • Display detail view of portfolio with multiple screenshots. Optionally show with the lightbox javascript library.

Screenshots

Frontend shots
View with a list of entries and a thumbnail list:

img-1

Detail view:

img-2

Backend shots
Plugin configuration, general tab:

img-3

Record list, sites and categories:

img-4

Record editing, site:

img-5

Record editing, category:

img-6

Users manual

Installation

Install the extension with the extension manager.

Create a sysfolder to store the portfolio and category entries

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

To make TYPO3 automatically clear the cache of the portfolio pages in the frontend, add the following snippet of TSConfig to the 'page properties' of the sysfolder:

TCEMAIN.clearCacheCmd = [comma seperated list of page id's on which you have portfolio plugins]

Whenever you add or modify a portfolio entry, the cache of the frontend pages will be cleared.

Create a page containing the portfolio plugin

  • Create a new page for the websiteportfolio plugin.
  • Insert the plugin by choosing 'Create page content' and selecting 'Webdesign portfolio' from the plugin list.
  • Choose what to display. You could start out with 'LIST'.
  • Choose a startingpoint. This will probably be the sysfolder you just created.

Create a category (optional)

Go to the portfolio sysfolder and create a new record of type 'Webdesign portfolio category'.

To make sure you can select your newly created category when creating a new portfolio entry.

Create a webstie entry

  • Go to the portfolio sysfolder and create a new record of type 'Webdesign portfolio site'.
  • Choose a title, image, category and description.
  • Check out the page in the frontend.

Adminstration

Describes how to manage the extension from a superuser point of view. That relates to Page/User TSconfig, permissions, configuration etc. which administrator level users have access to.

Configuration

The flexform configuration should be enough for most mortal users. You can load a sensible set of defaults by adding the static typoscript to your template.

It is also possible to 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 portfolio plugin.

((generated))

Adding static data to the template

Go to the 'template tools' and choose 'edit/modify' from the option list. Now choose; 'Click here to edit whole template record' to get access to the panel below. Here you can add static data used for the Potoblog extension.

img-7 The 2 static ext-templates offer you the following settings:

Default TS settings for the portfolio. Includes template, image sizes etc. (see reference).

default CSS-styles: This are the CSS-style definitions for the portfolio.

Reference
file.templateFile

Property

file.templateFile

Data type

file

Description

The default template file.

Default

EXT:websiteportfolio/pi1/websiteportfolio.tmpl

blogPid

Property

blogPid

Data type

int

Description

The page id of the portfolio page.

Default

0

pid_list

Property

pid_list

Data type

string

Description

The PID of the page (or comma separated list pf PIDs) where your portfolio entries are located.

Default

0

listPid

Property

listPid

Data type

int

Description

The page id of the list page.

Default

0

singlePid

Property

singlePid

Data type

int

Description

The page id of the detail page.

Default

0

screenshotWidth

Property

screenshotWidth

Data type

int (pixels)

Description

The images of entries will be scaled down to this width if they are wider.

Default

300

thumbnailHeight

Property

thumbnailHeight

Data type

int

Description

All thumbnails will be scaled to this height.

Default

75

useLightBox

Property

useLightBox

Data type

boolean

Description

Use the lightbox image library (http://www.huddletogether.com/projects/lightbox2/)

Default

0

Tutorial

A full point-a-to-b-to-c walk-through of an application of the extension. Include screendumps.

Known problems

None. Please let me know if you do run into any.

To-Do list

Extend documentation. Make a nice tutorial.

Changelog

0.1.11 (STABLE)

Version

0.1.11 (STABLE)

Changes

Switched to type USER.

Date

10-09-2006

0.1.10 (STABLE)

Version

0.1.10 (STABLE)

Changes

Changed thumbailing behaviour in single view. Should be more clear now.

Date

09-09-2006

0.1.9 (STABLE)

Version

0.1.9 (STABLE)

Changes

  • Updated manual with new screensot
  • Now supports multiple screenshots per portfolio entry
  • Can use lightbox2 javascript to display screenshots

Date

07-09-2006

0.1.4 (STABLE)

Version

0.1.4 (STABLE)

Changes

  • Manual updated (changelog).
  • site title varchar can now hold 200 chars instead of 50
  • results_at_a_time set to 1000

Date

02-09-2005

0.1.1 (STABLE)

Version

0.1.1 (STABLE)

Changes

  • Manual updated.
  • Added nice icons.
  • Removed thumbList Pid, since it is not used.
  • Updated css.
  • Gone to STABLE.

Date

01-09-2005

0.1.0 (BETA)

Version

0.1.0 (BETA)

Changes

Initial release

Date

31-08-2005

img-8 websiteportfolio - 6