SlideshowGalleryPro TheManualver.1.3.2
March2011TableofContentsIntroduction..................................................................................................................................................1
Howitworks.................................................................................................................................................2
WordpressImageGallery
.........................................................................................................................2
.
ManageSlides...........................................................................................................................................2
HardCoding:EmbeddingthroughPHP.........................................................................................................5
ManageSlides:..........................................................................................................................................5
WordpressImageGallery
.........................................................................................................................5
.
SlideshowGalleryProOptions......................................................................................................................6
Troubleshooting............................................................................................................................................7
WordpressInstallationIssue.....................................................................................................................7
PluginConflicts..........................................................................................................................................7
ThemeConflicts........................................................................................................................................7
SlideshowGalleryProBug........................................................................................................................7
Introduction
SlideshowGalleryPro(SGPro)isapluginoriginallydevelopedbythehardworking
soulsatTribulant.Itookthisonasideprojectbecauseithadalotofgreatbones,butalotof
greatbugsandinefficiencies.Mygoalwastomakeitworkrightandlearnmoreabout
WordpressPluginsandhonemyjavascriptatthesametime.
Ioffermanyimprovementsatabasiclevelfreeforanyonethatwantsit.Butinorder
tosupportmycontinualdevelopmentofthepluginIalsoofferaFullEditiontoPaypal
donatorsaswellasaMemberssectiontothosethatdonateatthespecifiedlevel.
TherearecontinuedfutureeditionstowhatFullEditionhastooffer,andonly
Membersthatsignonforayearwillbeabletotakeadvantageofthemwithouthavingto
repay.TherearemanyotherperksIwillbeofferingtoMembersaswellsosignupifyoucan!
Howitworks
SlideshowGalleryProhas2majormethodsofusage,and2differentwaysofdisplaying.The
firstwayistoembedthegalleryusingtheWordpressImageGalleryor[slideshow]thesecondwayisto
useManageSlideswhichis[slideshowcustom=1]
WordpressImageGalleryTheWordpressImageGallerycomesstandardwithyourbasicwordpressinstall.Its
whatiscreatedonceyouaddasingleimageintoaWordpresspost.Onceyouaddapicturethe
imagescreenforapostwillsayGallery(#),#beingtheamountofimagesassociatedwiththat
post.
Sonowifyouembedwith[slideshow]intoapostyoullseetheoneimageinyourWP
ImageGallery!Itsthateasy.Itwillalsobeusingallthedefaultsyouvesetunderyour
Configurationpage.Letslookatacloserexampleofembeddingthe[slideshow]:
Ofcourseitdoesntmakesensetouseaslideshowifyouonlyhaveoneimageinyour
gallery,somakesureyouhaveatleast3.Themorethemerrier!
ManageSlides
StartingwithManageSlidesyoucaneitheruploadanewimageoruseanimageyouve
alreadygotonline.
First,touseanimagethatyouvealreadygotsomewhereelseonyourWordPresssite,
gototheMediasection(asshownbelow),gotoLibrary,andsearchforyourimage.Clickonthe
imageorimagenametogettotheEditMediapage.
Nowyouvegotalinktouse!JustcopytheimagepathforuseinManageSlides
GotoManageSlidesandAddSlideandthenputinallmajorinfo.
OtherwiseaddingimagesthroughUploadFileiseasyandshoulddothetrick!Allimages
uploadinto:http://www.domain.com/wpcontent/uploads/slideshowgallerypro/.Ifyour
uploadsdirectoryisntwritableornotcreatedyoumayrunintoanissue.Onceyouclicksave
youshouldseetheimageaswellasitsthumbnailinthemainManageSlidespage.
ContinuetoaddslidesandthenembedsameasyouwouldintheWordpressImage
Galleryway[slideshow]exceptyouaddcustom=1,thus[slideshowcustom=1].The1isshowing
whichcustomslideshowyourusing.Thebasiceditionhasonly1optionwhilethefulledition
containsupto10.
NoticetheOrderof1?ClickOrderSlidesanddragtheslides.Afterthedraggingthere
willbeanoticebelowyourslidesthatsaysSlideshavebeenordered.Itautosaves.
Ifyouareinterestedindoingmorethanoneslideshowonyourwebsite(notonasingle
pageforthatiscurrentimpossible)youwillneedtogetthefulleditionorelseusethe
WordpressImageGallerytechniquementionedabove.
HardCoding:EmbeddingthroughPHP
Ifyourenotadeveloperyoumayhaveasomewhatdifficultwrappingyourheadaroundthis
code.Mysuggestiontoyouistonotworryaboutit!Justcopyandpastethecodeanditwillrunits
magic.Theykeyisgoingtobewheretopastenotwhatthecodemeans.Youwillneedtoeditoneof
yourphpfilesandpastethiscode.Thefilemustendin.phporthiswillnotwork,typicallyindex.php,
home.php,page.php.IalsoinviteyoutolearnaboutWordPressTemplatePages,inmyopinionthebest
waytoutilizehardcoding.
ManageSlides:ThemajorthingtokeepinmindwithManageSlidesisthatyouhavetocallapost_idofnull,this
causesthescripttodefaulttoManageSlides.
WordpressImageGalleryHereisanexampleofpullingtheimagesfromapostfromCompanyPagewithanIDof7.And
notwantingtoinserttheattachmentIDs231and324.
OnlyontheHomePage?? Remember! is_home()meansnotonthehomepage.
Manyofthefeaturesthatworkonthe[slideshow]embedcurrentlydontworkonthehardcodeyet.
Futureeditionsareforareasonthough!
SlideshowGalleryProOptions
Havingaslideshowinyourwebdevtoolbeltisnice.Havingahighlycustomizableslideshowis
frigginfantastic.Itsmyjobtoincreasethecustomizabilityofthisslideshowtoallowyoutohavethe
mostamountofwaystousethispluginasmanyuniquetimesasyoucouldpossiblywant.
Name Excludeattachments EmbedCall exclude=23,24 Description
Acommadelimitedwayofnotdisplayingspecific
attachmentIDs.Thesecanbefoundwhilehovering
overitemsintheMediaSection
AcommadelimitedwayofdisplayingONLYspecific attachmentIDs
Choosewhichslideshowsstartonpageload
Thisisthetypicallygraybarthatslidesupwiththe
imagetitleanddescription.Turnitofforon.
DontwanteitherapeskyThickboxopenerORhaving
animageopenuptoanotherwebpage?Usethis.
Insteadofusingpost_idtocallanoutsidepostusethe
pageslugifthatseasierforyouoraclient
Customizeyourlookofyourslideshoweverywhere!If
thumbnailsdontmakesenseforaspecificpage,then
turnoffthefunctionality
Includeattachments AutoSlide* ImageCaptions* NoLinking* Slug
Thumbnails*
include=25,26 auto=on caption=on nolink=true slug=about
thumbs=on
FullEditionOnlyName ResizedSlideshow EmbedCall w=500h=200
Description Changeyourslideshowtoaspecificsizedependingon
whereyoureputtingit.Notallpagesandpostsare alike!
Fulleditionsupportsupto10customslideshows.All
easilycalledandeasilyordered.
MultipleCustom Slideshows
custom=7
1.3FullEditionUpgrade:Changeyournavigationalarrows!
Insteadofjusttheclassic,youcannowhave3newoptions
*Pleasenotetherecognizedantonyms on/off true/false 1/0
TroubleshootingSoyourslideshowdoesntwork.WithallthecomplexitiesofwebsitesnowadaysImnotsurprised.Id
sayonlyabout95%ofSGProinstallationsworkrightoffthebat.Youmaygettothepointofpullingout
hair,butitdoesnthurttostartwithsimpletroubleshooting.Mostissuesariseinoneoftheseareasthat
youshouldtestoutonebyone: 1. 2. 3. 4.
WordpressInstallationIssuebytesrearrangingmovingandtransferring.Thinkaboutit.
PluginConflictsyouvegotanotherpluginthatsnotplayingnicewiththisone.
ThemeConflictsthemescanbeprettycomplexwiththeirownslideshowsandcustomfeatures
SGProbugHey.Ithappens.Eachhostingandbrowserenvironmentposesitsownchallenges
WordpressInstallationIssue PluginsPanel>SGProDeactivate
PluginsPanel>SGProDelete>Yesyouresure.
BasicEdition:ReinstallfromWordpresspluginssearch(searchforSlideshow)
FullEdition:Redownloadfromthewebsiteortakeyourpreviouslydownloadedfile.
o
Headtothispath:/wpadmin/plugininstall.php?tab=upload(orclickUploadunderAdd)
o Andfindtheslideshowgallerypro.zipandinstall!
PluginConflicts IfyouhaveCufonrunningyoumaywanttodeactivateiton
Deactivateeverypluginonyoursite
ActivateonlySGProandtestitonapagethathasphotosonit.Add[slideshow]tothatpage.
ThemeConflicts Withallotherpluginsstilldeactivated
SwitchyourthemetoTwentyTenorClassic
Testtheslideshow.Ifitworksproperlynowthenthereismostlikelysomejavascriptrunning
thatisnotplayingnicelywithSGPro.Workwithawebdeveloper(orhireCameronbetween
$55and$100)totweakyourthemetoallowforSlideshowGalleryProtoworkproperly.
SlideshowGalleryProBug
IfSGProaintworkinwitnostinkincomplexthemeornostinkincomplexpluginsTHENWHAT
THEHELLISIT????
AreyousuuureyouhavePHP5installedonyourhostingenvironment?
InstalltheFirebugAddonforFirefox.ClicktheConsoletabandrefreshthepageyouwant
SGProtobeon.Arethereanybigrederrorspoppingup?Scrollthroughanddoublecheck.
IfyourightclickandViewSourcedoyouseeadivforslideshowwrapper?Issomething
poppingupjustnottheslideshowdisplayingpicturescorrectly?Letpeopleknowonthe
WordpressForumswhatissueyourehavingwithasmuchdetailaspossibleandalinktothesite
oradecentscreenshotwithFirebugrunning.
http://wordpress.org/tags/slideshowgallerypro#postform
