EXT: Smallads¶

Table of Contents¶

EXT: Smallads 1

Introduction 1

Installation 2

Styling 3

Backend module 3

Configuration 3

Form Code 6

Categories 10

Defining sub-categories 10

Administration 11

More options 11

Known problems 11

To-Do list 11

Changelog 11

Introduction¶

Website users can publish smallads, browse and search them.

Features¶

• Auto fill-in: If a website user inserts a new smallad and she or he is logged in, her or his userdata will be inserted (phone, email, user id).
• Editable smallads: Frontend users may come back later and edit their own smallads or delete them.
• Editor review: If you want, new smallads can be hidden, until an editor reviews them.
• Email notification: Mails are sent to the user and to the editor each time a smallad is inserted.
• Categories: You can use different categories. Each smallad can have two categories. The second category can have a sub-category which changes dynamically. For example: First category: Buy, Sell. Second category: Clothing, Books. Sub-category: Shoes [Clothing], Trousers [Clothing]; Novels [Books], Comics [Books]
• Use sysfolders: As the smallads are stored in pages (sysfolders), you can also have completely different instances of the plugin in your website by using different sysfolders.
• Images: The use of images in smallads is supported. Frontend users may upload images.
• Backend module: There is also a backend module allowing you to export, unhide or delete a large number of smallads at once.
• Multi language: english, german, french, finnish, netherlands, greek.

Live Demo¶

You can see a working installation at http://www.ms- verlag.de/KORALLE_Kleinanzeigen_lesen.187.0.html (german language). This example does not include the sub-category.

Here is an example using the sub-category-feature: http://www.tourenfahrer.de/index.php?id=1643

Screenshots¶

Installation¶

Get the extension ke_smallads from the extension repository and install it.

Go to your template and include the static typoscript code from the extension.

Create a page and insert a insert a content element “general plugin” and select “Smallads” afterwards.

Select the mode “show smallads”.

Create a sysfolder (called for example “Smallads data”) and use it as startingpoint for your plugin.

Create a second page, insert the plugin again, and select the mode “show form for a new smallad”. Use the same startingpoint. On this page, users will be able to insert new smallads.NOTE: In TYPO3 CMS before version 6.0 the field “startingpoint” is called “Record Storage Page” and can be found in the “Behaviour” tab:

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

Styling¶

There's no HTML template. Edit ke_smallads.css to fit your layout.In the folder typo3conf/ext/ke_smallads/ (or typo3/ext/ke_smallads/) you find a css file with all the css used in the plugin. Copy it to your template folder (e. g. fileadmin/template/), modify it to suit your needs and include it in your typoscript template, for example:page.includeCSS.smallads_css = fileadmin/ke_smallads.cssIf you just want to use the standard css file, you can also add this line to your typoscript template and leave the file where it is (assuming that “page” is you main page object):page.includeCSS.smallads_css = EXT:ke_smallads/example/ke_smallads.css

Backend module¶

There is a backend module, too. This gives you the possibility to export the smallads in order to use them in other applications. Please use the List-module to administrate the smallads.

The field “comment”, which shows up in the backend in each smallad, is just for backend use. You may for example add something about the user (invoice address, ...). This will show up when you use the backend module to export the smallads.

Configuration¶

There is some static typoscript code provided with the plugin. Please have a look at the file

typo3conf/ext/ke_smallads/pi1/static/setup.txt

If you want to modify it in your template, just do it like this, for example:

plugin.tx_kesmallads_pi1.teaserNum = 5

Form Code¶

Please have a look at the file typo3conf/ext/ke_smallads/pi1/static/setup.txt.

You'll find the “smalladForm” configuration there. This is the default form configuration

You may overwrite it in your typoscript setup.

Categories and sub-categories¶

There are two category-types: first and second category. Please have a look at the “form code” above for how to define them. The second category may have a sub-category. Categories will only be shown in the frontend-filter, if there is at least one smallad for that category.

Administration¶

To administrate smallads, use the Web->List module and the new module Web->Smallads. You have to select the sysfolder where you stored the smallads.

You have to unhide smallads manually, if you set hideNewAds.

There is also a field called “reviewed”. You may check this field and then later unhide all reviewed smallads at once using the backend module. This is useful, if you want to review the smallads from immediately after they are submitted, but publish all smallads at one time and not one after another. To do so, use the module Web->Smallads.

With Web->Smallads, you can also delete all unhidden smallads at once or export reviewed smallads into a large list, with or without connected user data. Remember, these functions work only with “reviewed” smallads. If you want to use this functions, but don't need the “reviewed” functionality, just set the option “markNewAdsAsReviewed”. So every new smallad is marked as “reviewed” from the beginning and may use the backend module to administrate them.

Create a menu for categories¶

How to display each category on a single page (and use that pages to generate a typoscript menu):

• Create a page for each category (in a standard installation, these are: All, For Sale, Wanted, Miscellaneous).
• Create an ext. template on each page, in that template select the category to display, set the “mode selector” top “buttons” and disable the mode selector, for example this is the typoscript setup code for the “For Sale” page (where “1” ist the number of the category to show)

plugin.tx_kesmallads_pi1 {

modeSelectorType = buttons

showModeSelector = 0

# show category 1

listView.mode = 1

}

Insert a smallads plugin “listview”.

Known problems¶

If you have problems with your website running under utf-8 and the special chars (umlauts) are not displayed correctly, try to copy and paste the hole setup.txt into your Typoscript SETUP-Template.

Changelog¶

Version 1.2.0 (2012/12)

made compatible with TYPO3 CMS 4.7 and 6.0, removed calls to deprecated functions

Version 1.2.0 (2010/09) [version number was not updated]

• updated the manual
• New feature: send mail to a usergroup (not only single user). See typoscript setup. Thanks to Walter Kruml.
• Removed some options from RTE.
• Added greek translation. Thanks to Stefanos Karasavvidis.
• New feature: multi-category selection. Thanks for sponsoring toenorMedia GmbH & Co.KG.

Version 1.1.3 (2010/06)

• New feature: check characters left in content-field dynamically while typing (“You have 123 characters left.”). Uses javascript. TS-option: checkCharactersLeftWhileTyping.
• New feature: Either phone number or email address has to be filled out.
• Bugfix: “iscommercial” was non saved to database, therefore it was alwas empty.
• added "back" function if an error appears
• fixed pagebrowser (“pagefloat = center”)
• fixed javascript for confirmation of deletion of a smallad

Version 1.1.0 (2009/05)

• New feature: Two new categories, (Category 2 and Category 3), where Category 3 depends on the selection of Category 2 (the second category can have a sub-category which changes dynamically). Thanks to Reiner H. Nitschke Verlags GmbH for sponsoring the new dynamic category feature.
• In the list view, there are new filter options. Only the categories for wich smallads exist appear in these filters.
• Removing tags from submitted fields. The content field (and all the others of course) is not a RTE field in the frontend, so it is consequent to not allow the user to submit HTML. Although, the backend field ist still a RTE field. This is for historical reasons.
• Searchbox and mode selector don't disappear anymore after submitting a search word or selecting a mode/category.
• New TS-Option: ContentAndTitleMaxChars

Version 1.0.4 (2008/04)

• Bug fix: Chmod for uploaded images did not work correctly. On some servers the uploaded image could not be enlarged.
• Added some french translation.

Version 1.0.2 (2007/03)

• removed “htmlentities”-command when a new smallad is inserted, so german umlaute get stored correctly
• minor changes to the documentation

Version 1.0.1 (2006/11)

new configuration option listView.mode (see “More options”)

Version 1.0.0 (2006/10)

• New feature: Logged in users may now edit their own smallads or delete them.
• New feature: Users may now set the time for the smallad until it disappears (in days).
• The order of the smallads in the list view can now be set via typoscript.
• An error message is displayed in the frontend if no static template is included.
• The form for a new smallad is now rendered without tables to provide accessibility. You may have to adjust your css. If you want the old table layout, just have look into the setup.txt in the extension folder (you have to uncomment some lines there).
• If linebreaks are used in the “content”-field, they are now shown in the frontend.
• In the backend module there is now a new mode “export all smallads”.
• Added new languages: finnish, netherlands

EXT: Smallads - 10