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.

EXT: Advertising

Author:Kasper Skårhøj
Created:2002-11-01T00:32:00
Changed by:Robert
Changed:2011-04-04T13:58:19.430000000
Author:Robert Gonda
Email:robert.gonda@gmail.com
Info 3:
Info 4:

EXT: Advertising

Extension Key: tx_rtgadv

Copyright 2000-2011, Robert Gonda, <robert.gonda@gmail.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

EXT: Advertising 1

Introduction 1

What does it do? 1

Screenshots 1

Users manual 3

Adminstration 3

Configuration 4

Reference 4

Tutorial 5

Known problems 5

To-Do list 5

Changelog 5

Introduction

What does it do?

FE advertisement plugin. FE users create adverts. Module view list and detail of adverts. Please see screenshots.

Screenshots

FE search and list of adverts (navigation bar on bottom of list):

img-1

FE single view:

img-2 Edit advert record in BE:

img-3

Users manual

Po nainštalovaní sa súčasne naimportujú základné časové limity a kategórie v slovenskom jazyku, ktoré je možne upravovať, alebo vytvoriť nové. Pre tento import je potrebné v súbore ext_tables_static+adt.sql nastaviť pid stránky, kam sa majú tieto dáta naimportovať (v súbore treba nahradiť '43' vlastným pid).

Ďalej je potrebné vložiť plugin na vybranú stránku a nastaviť CMD podľa TS referenčnej tabuľky.

((generated))

Commands set
LIST

FIELD What to display

LIST

Description

Displays a list of adverts (default view if command not set).

SINGLE

FIELD What to display

SINGLE

Description

Displays a single advert item with all details.

CREATE

FIELD What to display

CREATE

Description

Displays a create form for add new advert by FE users.

LIST_EDIT

FIELD What to display

LIST_EDIT

Description

Displays a list of adverts for logged FE user.Possible operations for FE user: disable/enable, delete advert.

LAST_VISITS

FIELD What to display

LAST_VISITS

Description

Displays a list of last visitedadverts for logged FE user.

LIST_ADVERTISERS

FIELD What to display

LIST_ADVERTISERS

Description

Displays a list of FE users (advertisers) ordered by rating.

MESSAGES

FIELD What to display

MESSAGES

Description

Displays a list of private messages for logged FE user.

Adminstration

See Configuration.

Configuration

Reference

Reference (TypoScript)

cmd

Property

cmd

Data type

string

Description

Module view command;possible values:- CREATE

- UPDATE

- MESSAGES

- BUY

- REPORT

- SINGLE

- LAST_VISITS

- LIST_ADVERTISERS

- LIST_CATEGORIES

- LIST_EDIT

- LIST

Default

LIST

file.template

Property

file.template

Data type

file

Description

Path to HTML template

Default

pid

Property

pid

Data type

array

Description

Storage/views pages:

Example:

plugin.tx_rtgadv_pi1 {
  pid {
    system =
    # list view
    list =
    # single view
    single =
    # create form
    create =
    # list of feusers adverts
    listEdit =
    # adverts, last visits
    advertsStorage =
  }
}

Default

adminEmail

Property

adminEmail

Data type

string

Description

Admin email address, for email notifications.

Default

adminName

Property

adminName

Data type

string

Description

Admin name, for email notifications.

Default

Test

ignoreGPcmd

Property

ignoreGPcmd

Data type

boolean

Description

Disable command (cmd)form GPvars (GET/POST).

Default

0

limit

Property

limit

Data type

int

Description

Limit for adverts list (items per page).

Default

4

zone.where

Property

zone.where

Data type

string

Description

SQL condition for static_country_zones table (for select location with adverts search form)

Default

AND zn_country_iso_nr = 703

noOverwrite

Property

noOverwrite

Data type

boolean

Description

No overwrite old file in ext. directory with new file with same filename.

Default

1

fileMode

Property

fileMode

Data type

string

Description

Permissions for uploade files (used in chmod).

Default

0755

image.extInclude

Property

image.extInclude

Data type

string

Description

Comma separated list of allowed extensions for uploaded file (image).

Default

jpg, jpeg, bmp, gif, png

image.maxsize

Property

image.maxsize

Data type

int

Description

Max size of uploaded fiel in bytes.

Default

100000

required

Property

required

Data type

array

Description

List of required fields in create form.

Example:

plugin.tx_rtgadv_pi1 {
  required {
    title = 1
    text = 1
    email = 1
  }
}

Default

errorWrap

Property

errorWrap

Data type

wrap

Description

Wrapping for form error messages

Default

<p class="error">|</p>

stdWrap

Property

stdWrap

Data type

array

Description

Wraping any selected fields for marks rendering (see example below).

Default

ratingsEnable

Property

ratingsEnable

Data type

boolean

Description

Enable rating for advertisers (use extension ratings).

Default

0

ratingsConfig

Property

ratingsConfig

Data type

array

Description

Ratings configuration.

Example:

plugin.tx_rtgadv_pi1 {
    userFunc = tx_ratings_pi1->main
    storagePid = 0
    templateFile = EXT:ratings/res/ratings.html
    minValue = 1
    maxValue = 5
    ratingImageWidth = 11
    additionalCSS =
    mode = auto
    disableIpCheck = 0
}

Default

_CSS_DEFAULT_STYLE

Property

_CSS_DEFAULT_STYLE

Data type

string

Description

Default CSS styles

Default

[plugin.tx_rtgadv_pi1]

((generated))
Example
plugin.tx_rtgadv_pi1 {
  file.template = {$plugin.tx_rtgadv_pi1.file.template}
  pid {
    system = 40
    list = 20
    single = 21
    create = 22
    listEdit = 23
    advertsStorage = 41
  }
  limit = 4
  zone.where = AND zn_country_iso_nr = 703
  advert.endtime = 30
  noOverwrite = 1
  fileMode = 0755
  image.extInclude = jpg,jpeg,bmp,gif,png
  image.maxsize = 100000
  errorWrap = <p class="error">|</p>
  stdWrap {
    textShort {
      wrap = |
      stripHtml = 1
      crop = 160|...|1
    }
    text {
      wrap = |
    }
    imageMini {
      file.maxW = 15
      file.maxH = 15
    }
    image {
      file.maxW = 200
      file.maxH = 200
      params = class="imageleft" align="left"
      imageLinkWrap = 1
      imageLinkWrap {
        enable = 1
        bodyTag = <body bgcolor="#ffffff">
        wrap = <a href="javascript:close();">|</a>
        width = 600m
        height = 600m
        JSwindow = 1
        JSwindow.newWindow = 1
        JSwindow.expand = 17,20
      }
    }
  }
}

Tutorial

...

Known problems

Send me mail, if any...

To-Do list

...

Changelog

10-12-27 Robert Gonda <>

* New/changed advert atributes:

- category - more categories (multiselect)

- images (max 5)

- keywords

- bonus

- city

- payment

- latitude (unused)

- longitude (unused)

- conditions (textarea)

* New function/view:

- update advert by FE user (owner)

- report advert

- FB like it button

- rating FE user (use extension ratings)

- last visits memory for logged FE user

- list advertisers (feusers) ordered by rating value

- send buy message (private, inserted to DB, sended by mail)

- send reply to buy message (iserted to DB, sended by mail)

08-11-05 Robert Gonda <>

* More features and bugfixes

08-01-28 Robert Gonda <>

* Bugfix: remove space characters for uploaded image file

07-11-05 Robert Gonda <>

* Initial release

img-4 EXT: Advertising - 6