.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ================ 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: websiteportfolio ================ Extension Key: **websiteportfolio** Copyright 2000-2002, Michiel Roos [netcreators], 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: 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: Introduction ------------ .. _What-does-it-do: 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: 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: Screenshots ^^^^^^^^^^^ .. _Frontend-shots: Frontend shots """""""""""""" .. _View-with-a-list-of-entries-and-a-thumbnail-list: View with a list of entries and a thumbnail list: """"""""""""""""""""""""""""""""""""""""""""""""" |img-1| .. _Detail-view: Detail view: """""""""""" |img-2| .. _Backend-shots: Backend shots """"""""""""" .. _Plugin-configuration-general-tab: Plugin configuration, general tab: """""""""""""""""""""""""""""""""" |img-3| .. _Record-list-sites-and-categories: Record list, sites and categories: """""""""""""""""""""""""""""""""" |img-4| .. _Record-editing-site: Record editing, site: """"""""""""""""""""" |img-5| .. _Record-editing-category: Record editing, category: """"""""""""""""""""""""" |img-6| .. _Users-manual: Users manual ------------ .. _Installation: Installation ^^^^^^^^^^^^ Install the extension with the extension manager. .. _Create-a-sysfolder-to-store-the-portfolio-and-category-entries: 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 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: 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: 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: 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: 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: ((generated)) ^^^^^^^^^^^^^ .. _Adding-static-data-to-the-template: 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: Reference """"""""" .. ### BEGIN~OF~TABLE ### .. _file-templateFile: file.templateFile ~~~~~~~~~~~~~~~~~ .. container:: table-row Property file.templateFile Data type file Description The default template file. Default EXT:websiteportfolio/pi1/websiteportfolio.tmpl .. _blogPid: blogPid ~~~~~~~ .. container:: table-row Property blogPid Data type int Description The page id of the portfolio page. Default 0 .. _pid-list: pid\_list ~~~~~~~~~ .. container:: table-row 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: listPid ~~~~~~~ .. container:: table-row Property listPid Data type int Description The page id of the list page. Default 0 .. _singlePid: singlePid ~~~~~~~~~ .. container:: table-row Property singlePid Data type int Description The page id of the detail page. Default 0 .. _screenshotWidth: screenshotWidth ~~~~~~~~~~~~~~~ .. container:: table-row 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: thumbnailHeight ~~~~~~~~~~~~~~~ .. container:: table-row Property thumbnailHeight Data type int Description All thumbnails will be scaled to this height. Default 75 .. _useLightBox: useLightBox ~~~~~~~~~~~ .. container:: table-row Property useLightBox Data type boolean Description Use the lightbox image library (http://www.huddletogether.com/projects/lightbox2/) Default 0 .. ###### END~OF~TABLE ###### .. _Tutorial: Tutorial -------- A full point-a-to-b-to-c walk-through of an application of the extension. Include screendumps. .. _Known-problems: Known problems -------------- None. Please let me know if you do run into any. .. _To-Do-list: To-Do list ---------- Extend documentation. Make a nice tutorial. .. _Changelog: Changelog --------- .. ### BEGIN~OF~TABLE ### .. _0-1-11-STABLE: 0.1.11 (STABLE) ^^^^^^^^^^^^^^^ .. container:: table-row Version 0.1.11 (STABLE) Changes Switched to type USER. Date 10-09-2006 .. _0-1-10-STABLE: 0.1.10 (STABLE) ^^^^^^^^^^^^^^^ .. container:: table-row 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: 0.1.9 (STABLE) ^^^^^^^^^^^^^^ .. container:: table-row 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: 0.1.4 (STABLE) ^^^^^^^^^^^^^^ .. container:: table-row 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: 0.1.1 (STABLE) ^^^^^^^^^^^^^^ .. container:: table-row 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: 0.1.0 (BETA) ^^^^^^^^^^^^ .. container:: table-row Version 0.1.0 (BETA) Changes Initial release Date 31-08-2005 .. ###### END~OF~TABLE ###### |img-8| websiteportfolio - 6 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 522 .. :id: Afbeelding1 .. :name: Afbeelding1 .. :width: 649 .. |img-2| image:: img-2.png .. :align: left .. :border: 0 .. :height: 337 .. :id: Afbeelding2 .. :name: Afbeelding2 .. :width: 665 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 562 .. :id: graphics1 .. :name: graphics1 .. :width: 572 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 253 .. :id: Afbeelding4 .. :name: Afbeelding4 .. :width: 424 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 722 .. :id: Afbeelding5 .. :name: Afbeelding5 .. :width: 551 .. |img-6| image:: img-6.png .. :align: left .. :border: 0 .. :height: 116 .. :id: Afbeelding6 .. :name: Afbeelding6 .. :width: 449 .. |img-7| image:: img-7.png .. :align: left .. :border: 0 .. :height: 155 .. :id: Afbeelding7 .. :name: Afbeelding7 .. :width: 537 .. |img-8| image:: img-8.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102