EXT: Classifiedads¶

Table of Contents¶

EXT: Classifiedads 1

Introduction 1

Installation 1

Configuration 2

Administration 6

Known problems 6

To-Do list 6

Introduction¶

This extension can be use for creation of website of classified ads. Website users can publish classified ads, browse and search them, they have possibility to edit there own ads. On the homepage an overview table of all categories can be found.

The example of this extension can be found on http://www.musicgear.de/ (website is only german).

If a website user inserts a new ads and he is logged in, his userdata will be inserted (phone, email, user id).

As the basis for extension classifiedads was used and further developed to suit customer needs.

Supported languages at this time: english and german

Installation¶

• Get the extension classifiedads from the extension repository and install it.
• Go to your template and include the static typoscript code from the extension (you will find default version in the file typo3conf/ext/classifiedads/pi/setup.tmpl).
• To insert the plugin, insert a content element “general plugin” and select “classifiedad” afterwards.
• Select the mode “Classifiedads”.
• Create a new sysfolder-page (callad i.e. “classifiedads”) and use it as startingpoint for your plugin.
• Create a new page, insert the plugin again, and select the mode “show form for a new classified / process form”. Use the same startingpoint. On this page, users will be able to insert new ads.

That's all you have to do to get the plugin running.

There are 4 more modes you may want to use:

• “show search form” shows a search form via category, subcategory and search word
• “show classifiedads / Show search results” shows the records which suite the search criteria.
• “show classified edit” is used to give fe-user a possibility to edit his own ads.
• “show overview table” shows a table of all categories and ammont of ads in them

Configuration¶

There is some static typoscript code provided with the plugin /pi/setup.tmpl Please use it as starting point to configure template for this extension.

Below is the standard typoscript for the form. You can modfiy it like this:

plugin.tx_classifiedads_pi.classifiedForm.dataArray.10.label.lang.de = Kategorie

This is how to add a new category:

plugin.tx_classifiedads_pi.classifiedForm.dataArray.40 {

30.label = Another category

30.label.lang.de = Noch eine Kategore

30.value = another

}

You can also use the user defined fields user1 to user9. The values are stored comma-separated in the database. These are not in the standard typoscript code. Use them like this, i.e. to ask the user if he is over eighteen:

plugin.tx_classifiedads_pi.classifiedForm.dataArray {

26.type = user1=select

26.label = Age

26.label.lang.de = Alter

26.valueArray {

10.label = I'm over 18

10.label.lang.de = Ich bin über 18

10.value = ueber18

20.label = I'm under 18

20.label.lang.de = Ich bin unter 18

20.value = unter 18}

}

Standard form code:

classifiedForm {

layout = <tr><td class="csc-form-labelcell" valign="top">###LABEL###</td><td class="csc-form- fieldcell">###FIELD###</td></tr>

CHECK.layout = <tr><td class="csc-form-fieldcell" align="right" valign="top">###FIELD###</td><td class="csc-form-labelcell-check" valign="top">###LABEL###</td></tr>

badMess = Please fill in these fields:

params = class="inputclass"

params.check =

params.submit = class="submitclass"

params.textarea = class="inputclass"

REQ = 1

REQ.labelWrap.wrap = <p class="csc-form-label-req">|</p>

stdWrap.wrap = <table border="0" cellspacing="1" cellpadding="1" class ="csc-mailform"> | </table>

dataArray {

# Index no 10 has to be the category, you can change the values, but the index 10 has to stay

10 {

label = Category

label.lang.de = Rubrik

type = cat=select

required = 1

valueArray {

10.label = For Sale

10.label.lang.de = Verkaufe

10.value = For Sale

20.label = Wanted

20.label.lang.de = Suche

20.value = Wanted

30.label = Miscellaneous

30.label.lang.de = Sonstiges

30.value = Miscellaneous

}

}

20.label = Title

20.label.lang.de = Überschrift

20.type = title=input,35

20.required = 1

25.label = Content

25.label.lang.de = Anzeigentext

25.type = content=textarea,30,5

25.required = 1

28.label = Image

28.label.lang.de = Bild

28.type = file

30.label = Phone

30.label.lang.de = Telefon

30.type = phone=input,35

30.required = 1

40.label = Email

40.label.lang.de = Email

40.type = email=input,35

40.required = 1

40.specialEval = EMAIL

50.label = Should the email address be displayed?<br />If you don't check this field, youremail address will only be stored internally.<br /><br />Your phone number will be shown automatically.

50.label.lang.de = Soll Ihre Email-Adresse auf unserer Internetseite angezeigt werden?<br />Wenn Sie dieses Feld nicht auswählen, wird Ihre Email-Adresse nur intern gespeichert.<br /><br />Ihre Telefonnummer wird automatisch angezeigt.

50.type = displayemail=check

50.value = 1

80.type = newad=hidde

80.value = 1

90.type = formtype_mail=submit

90.value = Send

90.value.lang.de = Abschicken

}

}

Administration¶

None yet.

Known problems¶

Extension give a warning messages if there is no ads in database.

To-Do list¶

Fix all reported issues

to test this extension with typo3 version 4.0

support of database abstraction layer

EXT: Classifiedads - 5