Erweiterungen / Dateien & Medien / Pageavatar for Siena

Lightweight and flexible solution for linking files to pages and lists


PageAvatar is an advanced plugin used to associate pages with any types of files and manage such links. This is a simple yet powerful solution we normally use to build picture galleries for the websites powered by Cotonti.

Authors: esclkm, Kort, Cotonti Team



#1. Installation

The plugin is very easy to use. All you have to do is:

  1. Unpack upload and install Pageavatar plugin
  2. Add code snippets to page.add.tpl and page.edit.tpl (or category-specific templates)
  3. Add settings strings for each specific category (see below)
  4. Create folder(s) for file uploads as needed


Add plugin tags as follows:




Add plugin tags as follows:

      <!-- ENDIF -->


The structure of a settings string is as follows:

category code | path to uploads folder | thumbnail mask(s) | mandatory? | extension(s) | thumb creation mode

Brief explanation:

  • category code is... the category code (you can use 'all' to deal with all uploads)
  • path is the path to the folder you want to store the files in (we recommend ./datas/smth/)
  • thumbnail mask is best explained with an example: thumb_150-200 (add thumb_ prefix to the filename, height 150, width 200)
  • if you want to specify mandatory upload add 1 here, otherwise 0 (optional)
  • specify extensions you want to restrict uploads with (optional)
  • this is the way you want thumb to be generated: crop is crop, height gives you height priority, width -- width priority, frame means the thumb will stay within the specified height and width


You can now get your image paths in the LIST_ROW regular block or elsewhere, i.e.:

  • ./datas/{LIST_ROW_CAT}/{LIST_ROW_AVATAR} will give you ./datas/shop/page_234.jpg
  • thumb_{LIST_ROW_AVATAR} will give you thumb_page_234.jpg


Should you have any questions or would like to report a bug, feel free to open a topic at the forums.


Version History

  • 4.0-4.0.4 - several improvements and Compatibility with PHP 8.1
  • 3.27 - fixed crop bug (overwrite all files)
  • 3.26 - first public release, first 3rd party Siena plugin ever cool


Russian Manual for the Pageavatar Cotonti Plugin

1. pieter  6. April 2011, 10:59

Is there a special way for upgrading?

2. Kort  7. April 2011, 04:54

The plugin works around a single extrafield, so there are no special upgrade instructions except backing up database.

3. pieter  12. April 2011, 20:35

{PAGEADD_FORM_AVATAR_TITLE} is not giving any text output

4. Kort  17. April 2011, 19:06

Fixed for fresh installs. Otherwise input the extrafield title manually

6. Uch  22. April 2012, 15:23

"Fixed for fresh installs. Otherwise input the extrafield title manually" - нрифига не Fixed!

7. fade2k  3. Oktober 2012, 20:02

The new version works perfectly, thanks esclkm!

8. n0fx  30. Oktober 2016, 21:22

its not working with 0.9.19. when you try to upload on the page.edit, nothing happend. I mean it didnt upload image and didnt add data to page_avatar on the database.

9. n0fx  31. Oktober 2016, 00:45 is working. If you want thumb, you should use option like "all|datas/photos|thumb_150-200|0||crop"

Insgesamt: 9, auf Seite: 9

Nur registrierte Benutzer können Kommentare schreiben