package WebGUI::Asset::File::Image; =head1 LEGAL ------------------------------------------------------------------- WebGUI is Copyright 2001-2006 Plain Black Corporation. ------------------------------------------------------------------- Please read the legal notices (docs/legal.txt) and the license (docs/license.txt) that came with this distribution before using this software. ------------------------------------------------------------------- http://www.plainblack.com info@plainblack.com ------------------------------------------------------------------- =cut use strict; use WebGUI::Asset::File; use WebGUI::Storage::Image; use WebGUI::HTMLForm; use WebGUI::Utility; our @ISA = qw(WebGUI::Asset::File); =head1 NAME Package WebGUI::Asset::File::Image =head1 DESCRIPTION Extends WebGUI::Asset::File to add image manipulation operations. =head1 SYNOPSIS use WebGUI::Asset::File::Image; =head1 METHODS These methods are available from this class: =cut #------------------------------------------------------------------- =head2 definition ( definition ) Defines the properties of this asset. =head3 definition A hash reference passed in from a subclass definition. =cut sub definition { my $class = shift; my $session = shift; my $definition = shift; my $i18n = WebGUI::International->new($session,"Asset_Image"); push(@{$definition}, { assetName=>$i18n->get('assetName'), tableName=>'ImageAsset', className=>'WebGUI::Asset::File::Image', properties=>{ thumbnailSize=>{ fieldType=>'integer', defaultValue=>$session->setting->get("thumbnailSize") }, parameters=>{ fieldType=>'textarea', defaultValue=>'border="0"' } } }); return $class->SUPER::definition($session,$definition); } #------------------------------------------------------------------- =head2 generateThumbnail ( [ thumbnailSize ] ) Generates a thumbnail for this image. =head3 thumbnailSize A size, in pixels, of the maximum height or width of a thumbnail. If specified this will change the thumbnail size of the image. If unspecified the thumbnail size set in the properties of this asset will be used. =cut sub generateThumbnail { my $self = shift; my $thumbnailSize = shift; if (defined $thumbnailSize) { $self->update({thumbnailSize=>$thumbnailSize}); } $self->getStorageLocation->generateThumbnail($self->get("filename"),$self->get("thumbnailSize")); } #------------------------------------------------------------------- =head2 getEditForm () Returns the TabForm object that will be used in generating the edit page for this asset. =cut sub getEditForm { my $self = shift; my $tabform = $self->SUPER::getEditForm(); my $i18n = WebGUI::International->new($self->session,"Asset_Image"); $tabform->getTab("properties")->integer( -name=>"thumbnailSize", -label=>$i18n->get('thumbnail size'), -hoverHelp=>$i18n->get('Thumbnail size description'), -value=>$self->getValue("thumbnailSize") ); $tabform->getTab("properties")->textarea( -name=>"parameters", -label=>$i18n->get('parameters'), -hoverHelp=>$i18n->get('Parameters description'), -value=>$self->getValue("parameters") ); if ($self->get("filename") ne "") { $tabform->getTab("properties")->readOnly( -label=>$i18n->get('thumbnail'), -hoverHelp=>$i18n->get('Thumbnail description'), -value=>'thumbnail' ); my ($x, $y) = $self->getStorageLocation->getSizeInPixels($self->get("filename")); $tabform->getTab("properties")->readOnly( -label=>$i18n->get('image size'), -value=>$x.' x '.$y ); } return $tabform; } #------------------------------------------------------------------- sub getIcon { my $self = shift; my $small = shift; return $self->session->config->get("extrasURL").'/assets/image.gif' unless ($small); $self->SUPER::getIcon(1); } #------------------------------------------------------------------- sub getStorageLocation { my $self = shift; unless (exists $self->{_storageLocation}) { if ($self->get("storageId") eq "") { $self->{_storageLocation} = WebGUI::Storage::Image->create($self->session); $self->update({storageId=>$self->{_storageLocation}->getId}); } else { $self->{_storageLocation} = WebGUI::Storage::Image->get($self->session,$self->get("storageId")); } } return $self->{_storageLocation}; } #------------------------------------------------------------------- sub getThumbnailUrl { my $self = shift; return $self->getStorageLocation->getThumbnailUrl($self->get("filename")); } #------------------------------------------------------------------- =head2 getToolbar ( ) Returns a toolbar with a set of icons that hyperlink to functions that delete, edit, promote, demote, cut, and copy. =cut sub getToolbar { my $self = shift; return undef if ($self->getToolbarState); return $self->SUPER::getToolbar(); } #------------------------------------------------------------------- =head2 prepareView ( ) See WebGUI::Asset::prepareView() for details. =cut sub prepareView { my $self = shift; $self->SUPER::prepareView(); my $template = WebGUI::Asset::Template->new($self->session, $self->get("templateId")); $template->prepare; $self->{_viewTemplate} = $template; } #------------------------------------------------------------------- sub processPropertiesFromFormPost { my $self = shift; $self->SUPER::processPropertiesFromFormPost; my $parameters = $self->get("parameters"); unless ($parameters =~ /alt\=/) { $self->update({parameters=>$parameters.' alt="'.$self->get("title").'"'}); } my $storage = $self->getStorageLocation; $self->generateThumbnail($self->session->setting->get("maxImageSize")); $storage->deleteFile($self->get("filename")); $storage->renameFile('thumb-'.$self->get("filename"),$self->get("filename")); $self->generateThumbnail($self->session->form->process("thumbnailSize")); } #------------------------------------------------------------------- sub setSize { my $self = shift; my $input = shift; my $storage = $self->getStorageLocation; my $size = ($input > $storage->getFileSize($self->get("filename"))) ? $input : $storage->getFileSize($self->get("filename")); return $self->SUPER::setSize($size); } #------------------------------------------------------------------- sub view { my $self = shift; my %var = %{$self->get}; $var{controls} = $self->getToolbar; $var{fileUrl} = $self->getFileUrl; $var{fileIcon} = $self->getFileIconUrl; $var{thumbnail} = $self->getThumbnailUrl; return $self->processTemplate(\%var,undef,$self->{_viewTemplate}); } #------------------------------------------------------------------- sub www_edit { my $self = shift; return $self->session->privilege->insufficient() unless $self->canEdit; my $i18n = WebGUI::International->new($self->session, 'Asset_Image'); $self->getAdminConsole->addSubmenuItem($self->getUrl('func=resize'),$i18n->get("resize image")) if ($self->get("filename")); my $tabform = $self->getEditForm; $tabform->getTab("display")->template( -value=>$self->get("templateId"), -namespace=>"ImageAsset", -hoverHelp=>$i18n->get('image template description'), -defaultValue=>"PBtmpl0000000000000088" ); $self->getAdminConsole->setHelp("image add/edit","Asset_Image"); return $self->getAdminConsole->render($tabform->print,$i18n->get("edit image")); } #------------------------------------------------------------------- sub www_resize { my $self = shift; return $self->session->privilege->insufficient() unless $self->canEdit; if ($self->session->form->process("newWidth") || $self->session->form->process("newHeight")) { $self->getStorageLocation->resize($self->get("filename"),$self->session->form->process("newWidth"),$self->session->form->process("newHeight")); $self->setSize($self->getStorageLocation->getFileSize($self->get("filename"))); } my $i18n = WebGUI::International->new($self->session,"Asset_Image"); $self->getAdminConsole->addSubmenuItem($self->getUrl('func=edit'),$i18n->get("edit image")); my $f = WebGUI::HTMLForm->new($self->session,-action=>$self->getUrl); $f->hidden( -name=>"func", -value=>"resize" ); my ($x, $y) = $self->getStorageLocation->getSizeInPixels($self->get("filename")); $f->readOnly( -label=>$i18n->get('image size'), -hoverHelp=>$i18n->get('image size description'), -value=>$x.' x '.$y, ); $f->integer( -label=>$i18n->get('new width'), -hoverHelp=>$i18n->get('new width description'), -name=>"newWidth", -value=>$x, ); $f->integer( -label=>$i18n->get('new height'), -hoverHelp=>$i18n->get('new height description'), -name=>"newHeight", -value=>$y, ); $f->submit; my $image = '
'.$self->get(
'; $self->getAdminConsole->setHelp("image resize","Asset_Image"); return $self->getAdminConsole->render($f->print.$image,$i18n->get("resize image")); } #------------------------------------------------------------------- =head2 www_view A web executable method that redirects the user to the specified page, or displays the edit interface when admin mode is enabled. =cut sub www_view { my $self = shift; if ($self->session->var->get("adminOn")) { return $self->www_edit; } my $storage = $self->getStorageLocation; $self->session->http->setRedirect($storage->getUrl($self->get("filename"))); return ""; } 1;