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.

[Yankidank]

manilla: I would have to see what your template looks like to give you a more accurate example. I think the code I posted works fine on my test site (Wistie template). You might need to add a <div style="clear:both"></div> after the </div> if your content is overlapping the image. I suggest that you find help from someone on another thread or by searching Google for a solution that will work for you because I don't want to spend too much time supporting these types of questions since they are getting off topic from the original post.

jongaa: That Youtube example url works fine for me. Some sites don't allow you to access their images through this method. They occasionally have different types of hotlink protection to prevent software from grabbing images from them. I suggest you try a variety of sites and you will quickly find a site that doesn't disallow grabbing of their images for the Upload module. If you're looking for an example you can use this image url to test if it's working: http://www.pligg.com/images/donate.png
I'm also confused about your other post, why and where did you hardcode those two template urls?

[nellaitamil]

yankidank this module not worked.

[Yankidank]

Originally Posted by nellaitamil

yankidank this module not worked.

Your profile shows that you are running Pligg 9.9.0. If that's true you need to upgrade to the latest version (1.0.0 RC4) to use this module.
If you are already using the latest version, please give me a much more detailed bug report. "not worked" isn't very helpful and won't help me figure out what needs to be fixed. Please submit error messages, what version of Pligg (SVN number or official release number), Server specs such as PHP and MySQL versions, a step by step guide on what you did to install/upgrade the module or how you are trying to use it and a link to a site to test it out. As many of those details that you can give me the better, I really can't help you if you don't give me some of the most basic information.

[ucupzzz]

thankz... for the module...
But... where i can get templates hooks...

and how to use with other templates... i have install the module... and go to module configuration to setting this module.. but i do not meet any field to upload image when i want to submit a new story...

can you tell me how to setting this module in other templates...?

i use rc4

[Yankidank]

Module hooks are used to insert module data into your template files (.tpl) .
An example of a module hook would be: {checkActionsTpl location="tpl_pligg_head_start"}
This hook is placed just after the <head> tag in the pligg.tpl file. It's there so that if a module needs to insert any data into the top of your <head> area it can insert data there. It's important that your template uses module hooks and that they place them in relatively the same spots as where our default template uses them to ensure module compatibility with all templates.This page will help you determine where most of the module hooks are located. That's about as far into module hooks that I'm going to go on this post. You should open up a new thread if you want to discuss how module hooks work or have a question about moving or adding in module hooks.
The upload module has pre-set module hooks that you can select from so that you can set where you want the thumbnails to display. These template hooks are all found in the link_summary.tpl file.

[ucupzzz]

thank`s you so much Yankidank...

i used wistie templates and the Upload Module work well....

i`ll try to modification other templates to make this module work.. thank`s alot....

[BillyC]

Is it possible to let this module create thumbnails of the story's original page and display it?

[Yankidank]

Originally Posted by BillyC

Is it possible to let this module create thumbnails of the story's original page and display it?

If I understand you correctly, that feature would be done though a different module. I'm guessing you want it so that it fetches images from the submitted url similar to how Digg finds images and crops them into square thumbnails to display next to the description. We might end up developing it if enough users want to foot the bill to have it made. If you're interested please let me know how much you would be able to contribute.

[Techkr]

I also need feature that grabbing image from story link but I'm scared that it will increase server load or not? I see when I enable retrieve title from url sometimes it's take so long

[BillyC]

Originally Posted by Yankidank

If I understand you correctly, that feature would be done though a different module. I'm guessing you want it so that it fetches images from the submitted url similar to how Digg finds images and crops them into square thumbnails to display next to the description. We might end up developing it if enough users want to foot the bill to have it made. If you're interested please let me know how much you would be able to contribute.

Yep that's what I meant, unfortunately right now I'm not earning much with my Pligg sites so I couldn't pay for a module like that yet.

In the meanwhile, is there a way to display with every article a screenshot of the original article at the articl'es source? Just a screenshot of the entired page? I thought the default yget template had this feature....