This module allows you to attach a file or image to a Pligg article. There are a lot of settings to configure it from the Admin panel to allow you to do pretty much anything with it. This module comes with Pligg versions 1.0 RC3 and above.
An early Beta version of the module was included with 1.0 RC2, but we suggest that users uninstall it and start from scratch with the version provided with RC3 to prevent any bugs from appearing.

Support
This module was developed by the Pligg team and is being released for free, but we do ask that if you use this module please consider donating a small amount ($10-20) to help us recuperate our losses for the amount of time involved in developing this module. This is probably the most advanced module designed for Pligg yet and we designed it so that it could be used in a broad array of sites. Because we had to design it with so many uses in mind it took us a very long time to get it just right. If you plan on using this module for commercial use (generating income greater than $30/month from the site), we require that you submit a donation of at least $10.

Technical support will be provided for BUGS that are recognized as valid and applicable to a large number of sites. We cannot support requests for features unless you are willing to pay for the extra features to be developed and to allow the feature to be contributed back to the community.

Features:

• Upload image to your website
• Grab an image from another site
• Generate multiple thumbnails for attached images
• Attach files to articles.
• Select what file types you want to allow from the upload settings page. (Ex: zip jpg psd )
• Add additional fields for each uploaded file. Use it require a name, description, author, etc. for each file.
• Automatically embed image thumbnails into posts. Just tell it what template hook to use from the upload settings page.
• Automatically embed an attached image list. Like above, just tell it what template hook to use to place the list.
• Easily add HTML before and after the thumbnails or attached files list. Use these settings fields in the upload settings page to add the needed HTML to apply javascript effects to your images, or customize how the images and file list look.
• Use template tags to embed the uploaded images into your template.

Example:
Below is a screenshot of the upload module as seen at the top of Submit Step 2.


Below is a screenshot of what happens after I have attached an image and clicked the Upload button:


Upload Module Tags
If you want to manually control where images are inserted into story content you will want to use the image tags provided next to the example thumbnail(s) during the upload process in submit step 2. Example tags might be:

• {image1}
• {image1_100x100}
• {image2}
• {image2_250x250}

The numbers in those examples are from the sizes setup from the Upload module settings page. After you upload an image it should show a thumbnail and display one of these tags next to it for you to use if you want to embed it in the article.

Upload Module Template Tags
This module will insert thumbnails automatically into your template by using template hooks. This was designed so that you wouldn't need to edit your template files manually in order to start using the module. If you want to customize where the images are individually displaying in the template, for example show the first image at the top of the post and show the second uploaded image at the bottom, you should follow the usage examples below.

To insert the first attached image at it's original file size you will insert the code {$image1} into link_summary.tpl where you want it to display. The second uploaded image would be {$image2} and so on.

From the upload settings page I have created a thumbnail size of 500x500 pixels. This allows an uploaded image to have a maximum length of 500 pixels when being resized. So if you upload a 1000x500 pixel image it would be shrunk proportionately to 500x250 pixels. To embed that 500x250 pixel image into my template I would add the code {$image1_500x500} into link_summary.tpl to display the first uploaded file for a post at it's 500x500 pixel thumbnail size. {$image2_500x500} would display the second 500x500 attached file. In the case that no image is attached nothing extra will be inserted into your template.

Examples

Please see the attached image for a screenshot of the Upload module settings page and examples of what the upload process looks like for the submit step 2 page.

[simosmme]

i have another problem, there is a space between the image and the text, it is not perfectly aligned - is there a way to fix it?

example here

[dostalf]

Originally Posted by denislexic

I need some quick tip.

When the photo loads, it doesn't show a thumbnail. Also in the story summary, the image doesn't appear.

Any help would be greatly appreciated.

Thanks

Hi denislexic, I am still fighting with the issue. Any success dealing with it? It slowly drives me mad... Could the author of the module please comment? Help would be highly appreciated.

Thanks

[Yankidank]

I'm guessing that you guys are having trouble with customizing it, and since i don't want to write paragraphs about how it should be used I'll just say please read the readme.html file for the module and experiment with it before posting more follow ups. I'm guessing some errors could be caused by the hosting environment (php, mysql versions and features), but we worked most of those kinks out by now.

[dostalf]

Originally Posted by Yankidank

I'm guessing that you guys are having trouble with customizing it, and since i don't want to write paragraphs about how it should be used I'll just say please read the readme.html file for the module and experiment with it before posting more follow ups. I'm guessing some errors could be caused by the hosting environment (php, mysql versions and features), but we worked most of those kinks out by now.

Hi Yankidank, thanks for your follow up. I was initially not trying to customize anything, it just did not work. I.e. the thumbnails were not displayed as they should but no error messages were shown whatsoever. As a result I was looking for alternate ways... and tried to insert thumbnails by customizing the template. But that did not seem to work either. (As said before, in a listing of posts, the thumbnail is only displayed for the first item in this listing.)

I will check out readme.html now and see if I can figure something out. There is definitely some sort of bug in your code, though, as it seems I am not the only one with these problems.

[Yankidank]

I've tried this module in 4 different servers and haven't discovered any problems on any of them. We've tested it on more than just those 4 servers and have added bug fixes to increase compatibility with a wide range of web hosts. Most errors that people experience with both this module and Pligg CMS tend to be user errors. Make sure that you both read the documents provided with the module and pligg, and check the settings page for the module.

[user1500]

Hello, I am a new Pligg user. I was wondering if it is possible to use the Upload module and the RSS Importer module together. For instance if I am importing a RSS feed that contains an image tag for each story. Would it be possible to have the Upload module automatically upload each image file?

[Yankidank]

Originally Posted by user1500

Hello, I am a new Pligg user. I was wondering if it is possible to use the Upload module and the RSS Importer module together. For instance if I am importing a RSS feed that contains an image tag for each story. Would it be possible to have the Upload module automatically upload each image file?

No, there's no method to use RSS Import in combination with the Upload Module to do this. You would have to allow <img> tags in submissions from Admin > Configure > Submit. I haven't tried this, but maybe you could set the RSS Import module users (that it imports stories as) as a moderator and set the HTML tags that are allowed for moderators to <img>. The RSS Importer is something we haven't spent time updating in a while, so some features might not work with the latest version of Pligg.

[simosmme]

hello! thanks for that module, it's the most useful!

how can i ad photos, not only in the first page but inside the story page too?

ex. Samsung: νÎ*ες φωτογÏ�αφικÎ*Ï‚ μηχανÎ*Ï‚ PL70 & PL55 | techRADAR.gr: ανιχνεÏ�ουμε τις τεχνολογικÎ*Ï‚ ειδήσεις στην Ελλάδα (there is a photo, you can see it in the main page but not inside the story page...)

thank you a lot in advance, greetings from Greece

[jjj2]

Anyone can point us a proper direction, perhaps a tutorial how to modify the existing "Upload module" to support the lightbox, thickbox, fancybox, popeye...etc..

Thanks in advance.

[ronwaste]

TY for this Great Plugin but can u help me with something...

i want to hardoce 6 image positions under my storycontent right ofer the extra fields. i tried to put {image1_183x150} direct in the linksummary.tpl but after this the site is blank. can you give me a tip how can i hardcode the positions?

Thanx!