DOWNLOADINGLogin to your Member Dashboard and grab the latest release from your "My Subscriptions" page. An active membership is required.
- Joomla 2.5.x latest stable version is highly recommended. K2mart should also work with no problems under Joomla 1.7 but since this is not a LTS version it is not officially supported. If you are under Joomla 1.7, you are highly encouraged to upgrade to Joomla 2.5. K2mart v.2.x will NOT work with Joomla 1.5.
- K2 v2.6.3 or later.
- Virtuemart v2.0.16 or later is highly recommended. K2mart was tested with Virtuemart 2.0.16 and it should work with no problems with next versions of Virtuemart in the same 2.x.x series. K2mart is designed to work with the Virtuemart cart module (mod_virtuemart_cart), so it is recommened that you also enable this module on product pages. K2mart makes sure that when a user clicks on a product in that cart module, the user is properly redirected to the related K2 product page. K2mart v.2.x will NOT work with Virtuemart 1.x.
INSTALLATION & UPDATINGAfter you download the zip file, use the Joomla installer by navigating to Extensions->Extension Manager->Install/Uninstall and then choose to upload the zip file.
If you are updating from an older version of K2mart in the 2.x series, do not uninstall the old version. Simply head over to Extensions >> Install/Uninstall and choose to upload the new file. All K2mart files will now be updated maintaining your settings.
UPGRADEUpgrading from K2mart 1.x to K2mart 2.x is NOT supported. K2mart is based on two other extensions K2 and Virtuemart. Upgrading K2mart means that you should also upgrade them. Although K2 can be upgraded using the jUpgrade extension, there is no easy way to upgrade Virtuemart from version 1.x to version 2.x.
POST INSTALLATION CHECKSAfter installing K2mart, in order to ensure that everything is fine, you should check that K2mart plugins are installed and enabled. K2mart comes with one system and one k2 plugin. Both of them should be enabled.
SETUPAfter installing K2mart you have to select a K2 category as your catalog root through K2mart system settings. This is a required step in order to tell K2mart what’s the category that’s holding your catalog and your products. You can read more on this below on the settings section of this document.
HOW DOES IT WORK?K2mart is a powerful extension adding cart functionality to K2 items using Virtuemart, the most popular e-commerce solution for Joomla.
K2mart integrates most of Virtuemart's product features to K2 items by mapping and syncronizing Virtuemart products with K2 items. This way each K2 item inherits all of Virtuemart's product properties, including manufacturer, vendor, price, discounts, tax rates, currencies, stock, custom fields, dimensions and so on. Every time you save an item through K2, K2mart sends the product information to Virtuemart and keeps a reference between the product and the K2 item. When rendering K2 on the frontend, K2mart attaches the information from Virtuemart to the corresponding K2 item in the form of a block with product information and the required "add to cart" button.
This block output by K2mart comes in four bundled templates with three different layout files (for the K2 item view, K2 item listing view and K2 items fetched within K2 modules) and configuration parameters for each of them to make theming much more easier. These theming options are set into the "Settings" page within K2mart.
K2mart consists of an admin only component, two plugins and an admin module. For greater simplicity all the parameters of the extension can be found on the component along with the migrator. Read on for a complete explanation of each parameter found in K2mart.
WHAT'S SYNCEDIn this version, K2mart apart from using Virtuemart’s database tables to store the additional product data, is also performing a sync of some basic fields. The reason for this is to allow basic integration with some Virtuemart modules. The fields that are synced are the following:
|K2 item field||Virtuemart product field|
CREATING PRODUCTSOnce K2mart is installed and setup you can begin adding products. The process is exactly the same as creating a K2 item. The only difference is that you have to fill in some extra information regarding the product. In order to do this use the form provided by K2mart. The fields that are required is the SKU and the price. Once you complete them and hit save you have created your first product.
USING THE MIGRATORIf you have already set up your online shop with Virtuemart and you want to import your products to K2 you can use the K2mart migrator. K2mart migrator will build the corresponding K2 categories for your catalog based on Virtuemart category structure. It will also create a K2 item for every Virtuemart product it finds. Note that if migrator finds a Virtuemart product that is already assigned to a K2 item (has already been imported in the past), this product will be skipped. Also note that Virtuemart's multiple categorization is NOT supported. When the migrator finds a Virtuemart product that belongs to more than one Virtuemart categories it will map the generated K2 item to the corresponding K2 category with the deepest level among them. K2mart migrator will also create tags for Virtuemart categories and will tag each new generated item with them. K2mart migrator comes with three quick settings to customize the migration. These are:
K2mart migrator settings
- Catalog root category: All imported categories from Virtuemart will be placed under this category and they will inherit it's settings. Select one of the existing K2 categories or type a category name and let K2mart create this category for you using the default category settings. It is highly recommend that you first create a K2 category through K2, set the desired settings for this category and then use the migrator to import products to K2mart under this category (selecting this category from the list as the catalog root category). This will save you from a lot of work later, especially if you have a lot of products and categories.
- Ignore unpublished Virtuemart products and categories: If you check this the migrator will not import Virtuemart unpublished products and categories. This may be useful if you have a lot of unpublished products or categories in Virtuemart and you do not wish to import them.
- Process product images: Uncheck this if you want the migrator to not import the product images into the K2 items. This may also help if you face performance issues but it will lead to products without images.
Regarding the migration process you should note that:
- It may take a lot of time, depending on the Virtuemart products you have already and the setting about image processing. In any case do not interrupt the operation once you started it. Just wait to complete.
- K2mart migrator should normally be used one time. After the migration each new created product through K2 will auto saved to Virtuemart. If you run the migrator again you may produce uneeded duplicated K2 items and categories.
- The migration process requires that your system is NOT running PHP in safe mode. Otherwise it is very possible that you will get a max execution time error from PHP when you try to use the migrator.
- The K2mart migrator may require a lot of resources especially if you have a lot of products and you also want to process their images. PHP memory limit to 64M or greater is recommended if you want the migrator to also import the product images from Virtuemart to K2. This is an average value. Depending on your current number of products a greater value than this may be needed.
MANAGING PRODUCTSIn this version of K2mart product managing is more easy and simple. While you are viewing the K2 items administration list try to filter the items by category using the corresponding filter provided by K2. If you choose one category that’s inside your catalog ( your catalog is defined by the “Catalog root category ” setting ) then K2mart will enhance K2 items list with some extra columns and filters. The columns that will be added are the following:
K2 items list can be sorted using these columns. Additionally K2mart will add two extra filters. These are:
- Manufacturer filter. Allows to filter K2 items based on the manufacturer.
- Relation filter. Allows to filter K2 items to children and parents.
Those enhancements combined with K2 can give you a powerful managing interface for your shop. Operations like publish/unpublish , flag as featured are also applied to Virtuemart database. Finally, note that when you delete an Item through K2 all its mapped information is also deleted. This means that if a K2 item which is assigned to a Virtuemart product is deleted, the product is also deleted from the Virtuemart database. Note that those operations are applied to Virtuemart only when the K2 item being edited is under the K2mart catalog root category.
SETTINGSThe parameters are divided into the following areas:
- Layout/view settings. These settings control which elements (data from Virtuemart) are shown or hidden in the product info block that is output on K2 items. Each view has it's own settings: one for the K2 item view, one for the K2 item listings and one for K2 items displayed through K2 modules like mod_k2_content.
- System settings. These settings control global K2mart behaviour.
- Permissions. Provides basic integration with Joomla 2.5 permissions system. You can set the user groups which can configure or access administration interface.
Let's examine all the settings in detail:
K2mart layout settings
Layout settings include the following group of parameters
- Product name: This controls if the product name should be shown in the product info block. In most cases you need to set this to "Hide" as the K2 item title ( already displayed before the product info block ) will be the same.
- Product SKU: Show or hide the product SKU.
- Product URL: Show or hide the product URL.
- Product vendor: Show or hide the product vendor.
- Product manufacturer: Show or hide the product manufacturer ( along with a link opening a modal with manufacturer info ).
- Product price (If applicable): Show or hide the product price. Almost always you want to set this to "Show". Note that this requires that the product does have a price and that Virtuemart is also configured to show prices ( "Show prices" setting found under Virtuemart's configuration).
- Product packaging: Show or hide product packaging information.
- Product box info: Show or hide product boxing information.
- Product dimensions: Show or hide product dimensions.
- Product weight: Show or hide product weight.
- Product availability (If applicable): Show or hide product availability.
- Product shipping info: Show or hide product shipping info.
- Product rating : Show or hide product rating. Note that this requires that rating must be enabled through Virtuemart’s configuration.
- Product reviews (only for item view) : Show or hide product reviews. Note that this requires that reviews must be enabled through Virtuemart’s configuration.
- Product fields: Show or hide product fields. This refers to Virtuemart custom fields.
- Add to cart button (If applicable): Show or hide add to cart button. Note that this requires that Virtuemart is not configured to be used as a catalog only. You can find this under Virtuemart's configuration ("Use only as catalogue" setting).
- Cart product fields (only if add to cart button is enabled) : Show or hide cart product fields. This refers to Virtuemart’s custom fields that affect the product price.
- Quantity box (Only if add to cart button is enabled): Show or hide the quantity box for the add to cart form. This also requires that "Add to cart button" is set to "Show". If you set this to "Hide" the user will not be able to select the quantity of the product to add to the cart and the quantity will always be 1.
- 'Ask question' button: Show or hide the ‘Ask question’ link.
- Disable this layout: Set this to Yes if you want to globally disable K2mart for the specific view.
Note that the layout settings are identical on each of the first 3 tabs in "Settings". You obviously set them differently to reflect how you want your K2 catalog/shop to look like in the frontend.
K2mart system settings
System settings include the following group of parameters
- Catalog root category: Select the K2 category you want to redirect the user when they request Virtuemart's default page (called shop.browse or shop.index). Usually you will need to set this to your root category, meaning the category which contains all of your K2 items/products in your catalog.
- Template: Select which template will be used in K2mart rendering in the front-end. Templates are located in /plugins/k2/k2mart/tmpl/site directory. Overrides of the templates need to be placed under /templates/YOUR_JOOMLA_TEMPLATE/html/k2mart directory. Note that in order to create a new template it is not necessary to place it under /plugins/k2/k2mart/tmpl/site directory. You can place it directly under /templates/YOUR_JOOMLA_TEMPLATE/html/k2mart directory and K2mart will detect it.
- Cart only for registered users: Set this to yes if you want to hide the add to cart button for non-registered users.
- Show categories filter: Choose whether you want to display the category filter in front-end. This will allow the user to filter the products based on one or more categories.
- Show manufacturers filter: Choose whether you want to display the manufacturer filter in front-end. This will allow the user to filter the products based on one or more manufacturers.
- Show sorting filter: Choose whether you want to display the sorting filter in front-end. This will allow the user to sort the products by some common used criteria. NOTE: Virtuemart 2.0.2 removed the code that was counting the product sales. This means that the product sales sorting provided by K2mart won't be accurate until Virtuemart restores this issue.
- Enable AJAX: Choose wheter you want to enable AJAX functionality for the K2mart filters and the pagination in front-end.
- Show Virtuemart categories list on K2mart form. Setting this to "Yes" will provide K2mart product form with a select list of Virtuemart product categories. This way, when user creates a new product can also select the Virtuemart product categories that the product will be assigned. Note that this does not affect K2 categorization. This is added just for data manipulation. Advanced users can use this to apply batch operations to some products ( tax rate for specific Virtuemart categories for example).
- Show 'Advanced' tab on K2mart form. Setting this to "Yes" will display an extra tab in K2mart product form providing some advanced operations. Through this tab user can assign/unassign an existing Virtuemart product to a K2 item. Other operations provided by the advanced tab are a link for editing the product in Virtuemart and an option to completely remove the product from Virtuemart.
MVC TEMPLATING: THE POWER TO CUSTOMIZE YOUR LAYOUTYou can use HTML and CSS template overrides inside your Joomla template and completely change the way K2mart elements display on your website! So you can either choose to use the versatile base styling of the bundled K2mart templates or simply override them (both the HTML and CSS code) by copying the K2mart plugin's /tmpl/site/TEMPLATE folder within your Joomla template's /html folder. Each K2mart template uses 4 layout files (item listings, item view, item in module and filters) and one CSS file. Of course you are able to override all files or selected files, as you would with any other MVC component or module, with the better exception that K2mart overrides CSS files as well!
In order to override the built in templates you can simple copy /plugins/k2/k2mart/tmpl/site/TEMPLATE folder within your Joomla template's /templates/YOUR_JOOMLA_TEMPLATE/html/k2mart folder, as you would with components and modules. Whatever changes yo do from now on within this folder, will completely override the K2mart output, exactly as you would with any other MVC component or module.
Alternatively you can create your own template by placing your template folder to /templates/YOUR_JOOMLA_TEMPLATE/html/k2mart. There is no need to place your template to the plugin templates directory.
K2mart uses 4 layouts for listing, listing in modules, item pages and filters, with 1 associated CSS file. You are able to override all files or selected files, as you would with any other MVC component or module, with the better exception that K2mart overrides CSS files as well!
Below you can see the file structure of a K2mart template folder inside the plugin:
|-- (includes images used in the .php or .css files)
If you maintain this structure within /templates/YOUR_JOOMLA_TEMPLATE/html/k2mart/TEMPLATE you can override the entire plugin output!
FETCHING PRODUCT INFORMATION INTO K2 LAYOUTSSome of the product information that is available in K2mart layouts is now also available in K2 layouts to support more complex designs. In order to retrieve a K2mart variable when you are in the context of a K2 layout you can request the variable on the item object. For example if you want to fetch the product SKU inside the K2 item.php layout you can use the following code:
<?php echo $this->item->product->sku; ?>You can do the same for the most of the variables that are available in K2mart layouts. Note that in the example above $this->item variable is used. Depending on the context $item may be the item object.
DOWNLOADINGLogin to your Member Dashboard and grab the latest release from your "My Subscriptions" page. An active membership is required.
INSTALLATIONAfter you download the zip file, use the Joomla 1.5 installer by navigating to Extensions >> Install/Uninstall and then choose to upload the zip file.
You also need to enable the plugin, so navigate to Extensions >> Plugin Manager, locate "SuperBlogger" and choose to enable it. To set the various parameters of the plugin, just click on its name to access it's parameters page.
If you are upgrading from an older version of SuperBlogger, you do not need to uninstall the old version first. Simply head over to Extensions >> Install/Uninstall and choose to upload the new file. All plugin files will now be updated maintaining your settings.
- In order for SuperBlogger to function as intended, you need to have Joomla 1.5 installed (preferably the latest version) and working properly. Mootools should not be cut off in any way as it's required by both Joomla and the plugin.
- You also have to make sure that Joomla's /cache folder is writable, in other words, check that the permissions for this folder are 755 or 777.
- A Disqus.com account (and subdomain) which you can register for free at http://disqus.com, so comments are enabled on the plugin. SEF URLs in Joomla should be enabled for the comments counter feature to properly work, as Disqus utilizes the URL of each post to identify the number of comments for a specified article.
- A Twitter account (username) if you wish to enable the Twitter tools provided by the plugin. If you don't have one, you can sign up for free at http://twitter.com
- Optionally you can grab a code snippet from ShareThis.com or AddThis.com (for the social media button option) or get an ID from Outbrain.com (for the rating system). These are not needed as SuperBlogger already provides similar functionality, including a built-in ajax based rating system, using Joomla's article database. For the author avatar images, SuperBlogger uses the popular Gravatar.com service. If you enable the related setting in SuperBlogger, the plugin will ping Gravatar.com for an avatar assigned to the author's email address, if it exists, otherwise display a default avatar image (fully configurable via MVC templating).
HOW DOES IT WORK?SuperBlogger is a powerful plugin adding blogging functionality -the easy way- to Joomla 1.5 articles. The plugin integrates popular services like Disqus.com (for comments) and Twitter, along with commonly used blogging tools like tagging, rating, bookmarking and social media sharing. Add to that MVC template overrides and the ability to process images server-side and you got a real Wordpress contender, if not better in some areas!
SuperBlogger grabs the text of the article before output and processes it, adding the aforementioned blogging functionalities (and more). These functionalities can easily be set in the plugin's parameters, so you can choose which elements you want to make use of in your Joomla website and which not. Below we explained the plugin parameters one by one, while providing a screenshot on the right of the actual page in Joomla.
PLUGIN PARAMETERS (SETTINGS)IMPORTANT: The first time you go into the plugin parameters, hit "Apply" once so that the parameter area titles are refreshed and displayed properly (this is a known bug in Joomla, not the plugin).
The parameters are divided into the following areas:
- Select where to render the plugin: Choose where to "render" (enable) the plugin. This involves selecting specific or all categories (even the "Uncategorized" category) and/or selecting specific or all menu items, in which you want the plugin to render.
- Common settings: this is where we set the settings available across the entire plugin functionality, like our Disqus.com subdomain, our Twitter username etc.
- Listing Options: here we define the display of elements in listing pages like blogcategory for example. These options are limited compared to the Article Options because of the less space provided by default in listings.
- Article Options: here we define the display of elements in article pages.
Let's see now in detail what each parameter does:
The first area "Select where to render the plugin" features 2 multiple-selection boxes for choosing where to have the plugin enabled. You can select individual categories and/or menu items by pressing the Control button (Command button for Mac) and clicking on specific entries.
In "Common settings" we have the most options to set, but these are options we set only once.
- Enable Tags: if you use the Meta Keywords box inside the Joomla article form and enable this option, you can actually use these keywords as tags. When the user clicks on a tag in the frontend of your site, they are redirected to the "search" component display directly search results for this specific work or phrase.
- Enable Disqus comments: enable this option to turn commenting on. Requires a valid Disqus.com account and subdomain. Sign up for free at: http://disqus.com - If you want to use an existing comments system installed on your Joomla site like JomComment, simply disable this option.
- Your Disqus subdomain: After you signup with Disqus, you can link Disqus with your website. Disqus will ask you to "add a website", this is where you provide your site details. At the end it will produce a subdomain like mycoolblog.disqus.com. In this page you can see all your comments gathered and do all sorts of things, like adjust styling settings, moderate comments and more. The "mycoolblog" part is what you copy and paste in this option. Learn why Disqus is the best comment system worldwide at http://disqus.com
- Enable rating: Choose if you want to enable the rating widget or not. If you do, you can choose between SuperBlogger's built in ajax based rating (using Joomla's article database natively) or the free online Outbrain.com rating widget service (currently the most popular service of its kind). You can easily obtain your free code there without registering. Visit http://www.outbrain.com/get/ratings/Other and generate your outbrain.com snippet. Then just copy this code snippet in the textarea next to "Your Outbrain.com code". PLEASE NOTE that users of older version who used an ID for Outbrain.com can continue using their ID or grab a new code snippet to their preferred language. The ratings will not be lost.
- Social button code: Grab your social button code snippet from services like ShareThis.com or AddThis.com and paste it here.
- Twitter username: Enter here your Twitter username if you want to enable the Twitter tools provided by SuperBlogger (see technical requirements above). Enter nothing to disable Twitter tools. Avoid using a fake or non-existent Twitter username, otherwise the plugin will return an error (Twitter cannot provide a related warning when looking up a non-existent username, thus we cannot know the response).
- Enable TinyURL integration?: Enable this option to have URLs used in Twitter tools shortened, using the TinyURL.com service. Recommended.
- Twitter cache: This option defines the cache expiration time in minutes for your Twitter Status (feed) used in the "Latest Tweets" feature (set below). Prefer not to use less than 2 mins for performance reasons.
- Enable article image processing: This option enables image processing for the first image found in the article introtext. You can choose to enable image processing on listing pages, article pages or both. If you enable this option, you can set additional parameters in the options following.
- Image width on listing pages (px): The width in pixels for the processed first image in listing pages.
- Image width on article pages (px): The width in pixels for the processed first image in article pages.
- Image processing quality (%): The JPEG quality for the processed first image in listing and article pages. The less this value is, the lower the quality of the processed image gets. A value between 70 to 90 is ideal in most cases, mainting low image file size.
- Cache time for processed images (in mins): Set here the cache expiration time for processed images. When this time is reached, processed images are re-created. SuperBlogger uses caching for the generated images to minimize server load and improve site performance overall.
In "Listing Options" we have the following parameters:
- Rating widget: show or hide the chosen rating widget if enabled.
- Tweetmeme button: show or hide the TweetMeme badge for displaying re-tweets and an easy "tweet" this button
- Article tags: show or hide meta keywords presented as tags.
- Comments counter/anchor link: show or hide the comments counter (acting as anchor link to the comments form as well) if Disqus comments are enabled.
- Social button: show or hide a social button from online services like ShareThis.com or AddThis.com if set in "Common Settings".
- Font resizer: show or hide the font resizer widget for the main article text.
- 'Bookmark this' button: show or hide the link used for bookmarking a page in all browsers.
- Rating widget (with anchor link at the top): show or hide the rating widget along with an anchor link at the top of the article for easier user navigation.
- Comments counter/anchor link: show or hide the comments counter (acting as anchor link to the comments form as well) if Disqus comments are enabled.
- Related web content (provided by Sphere.com): if you enable this option, SuperBlogger will use Sphere.com for fetching related (to your article) content from across the web.
- Introtext drop cap: show or hide a drop cap derived from the first letter in the introtext. IMPORTANT: This option will only work if "image processing" is enabled. It will also perform some necessary HTML cleanup (code formatting) in the article's introtext.
- Custom HTML: in this textarea you can write some custom HTML code which will get displayed on all pages where SuperBlogger is enabled. Useful for copyright or other notices. Uses 2 variables [url] and [title] which are translated to the current article's url and title respectively.
- Author avatar (via Gravatar.com): If you enable this parameter, the plugin will look for the current author's email and request an avatar to Gravatar.com based on that email address. If it exists, it will fetch the appropriate image, otherwise it displays a default image.
- Article details: Show or hide article details like author name, date written, hits.
- Article section and category with links and associated RSS feed links: Show or hide the related article section and category (linked) with associated RSS feeds.
- Article tags: show or hide meta keywords presented as tags.
- Social links: show or hide buttons from services like Delicious, Digg, Technorati and more so users can share/bookmark your articles into these popular services.
- Latest author articles: fetch the latest articles from current author.
- Latest author articles limit: enter how many latest author articles to retrieve.
- Introtext for latest author articles: Show the introtext of the latest author articles
- Introtext word limit for latest author articles: Number of words to limit the introtext of the latest author articles.
- Latest tweets: fetch the latest tweets from the Twitter account set in "Common Settings" above.
- Latest tweets limit: enter how many tweets to fetch for the above parameter.
- Load a module position after the article text/before or after the comments: choose some module position to display in these places as stated by the options. Useful for displaying e.g. banners or the "related articles" module.
IMPORTANT Please note that if you have other "content" plugins installed in your Joomla website (e.g. AllVideos, Simple Image Gallery Free/Pro etc.), you can define the order in which they execute and process/modify Joomla article content by simply re-ordering them in the Plugin Manager. Plugins are executed in Joomla from top to bottom, exactly as you see them listed in the Plugin Manager. In order for SuperBlogger and other "content" plugins to work properly, make sure that SuperBlogger is re-ordered at the top of the "content" plugins stack (order number 0 or negative, e,g, -1). There is just ONE exception: if you are using the "page break" functionality in Joomla then you must re-order the "Content - Pagebreak" plugin first and have SuperBlogger as second.
MVC TEMPLATING: THE POWER TO CUSTOMIZE YOUR BLOG LAYOUTThe feature trully setting apart SuperBlogger from any other Joomla plugin is its MVC architecture, currently available in Joomla for components and modules only. That means you can use HTML and CSS template overrides inside your Joomla template and completely change the way the plugin elements display on your website!
So you can either choose to use the versatile base styling of the plugin or simply override it (both the HTML and CSS code) by copying the plugin's /plugins/content/jw_superblogger/tmpl folder within your Joomla template's /templates/YOURJOOMLATEMPLATE/html folder, as you would with components and modules. Then simply rename the folder /templates/YOURJOOMLATEMPLATE/html/tmpl to /templates/YOURJOOMLATEMPLATE/html/jw_superblogger. Whatever changes you do from now on within this folder, will completely override the plugin's output, exactly as you would with any other MVC component or module.
SuperBlogger uses 2 templates for listing and article pages, with 4 associated CSS files (one common, one for Disqus comments, one for IE6 and one for IE7 - just in case). You are able to override all files or selected files, as you would with any other MVC component or module, with the better exception that SuperBlogger overrides CSS files as well! That means if you copy just the main template file into your /templates/YOURJOOMLATEMPLATE/html/jw_superblogger, then the plugin will override that file, but not the other CSS files!
Below you can see the file structure of the /tmpl folder inside the plugin:
article.php /css |-- disqus.css |-- template_ie6.css |-- template_ie7.css |-- template.css /images |-- (contains image files currently used in the CSS files or inline) listing.php
If you maintain this structure within /templates/YOURJOOMLATEMPLATE/html/jw_superblogger you can override the entire plugin output!
SEE THE DEMOSSee a live demo of the plugin in action here: http://demo.joomlaworks.net/superblogger
See the plugin running across the "latest news" category in the above website at: http://demo.joomlaworks.net/superblogger/superblogger-running-in-a-category
If you navigate in the above demo website you'll be able to see Joomla articles with SuperBlogger enabled or disabled, so you can see first hand what features the plugin adds to the Joomla website.
JoomlaWorks has developed a non-Joomla distribution of Frontpage Slideshow to work on every website that supports PHP as a minimum requirement. We call this distribution Frontpage Slideshow "standalone". It's ideal for usage on non Joomla websites, like for example your corporate php website or your Wordpress blog or Drupal website! You can obviously use this version on any CMS that is based on PHP!
The following instructions apply to the all versions released after Sept. 29th, 2010 (v2.x).
Login to your Member Dashboard and grab the latest release from your "My Subscriptions" page. An active membership is required.
Locate (or download from your purchase email) the file FrontpageSlideshow-vX.X.X_STANDALONE.zip (where X.X.X is an incremental version number), extract it and upload its contents (a folder called "fpss" and the example page called example.php) on the root of your website. So if were uploading this to joomlaworks.net, I should see the example.php page by requesting joomlaworks.net/example.php.
Let's quickly setup the demo slideshow included within:
1. After you upload the files to your server, you need to edit the example.php to alter the php snippet which will bring up the slideshow. Use an FTP client to open/edit the file directly from your server (or do it locally and upload again)...
2. Inside the example.php file you will see this PHP code block (snippet):
<?php /* Frontpage Slideshow: Setup Steps */ /* Please refer first to the online documentation here:
// 1. Enter the name of your slideshow $slideshow = "demo"; // 2. Enter your site's URL (without trailing slash) $siteURL = ""; // e.g. http://www.site.com or http://www.site.com/folder if your site is in a subfolder // 3. Enter the absolute path of your site on the server (without trailing slash) $sitePath = ""; // e.g. /home/user/public_html or /home/user/public_html/folder if your site is located in a subfolder
// Include the slideshow include_once($sitePath."/fpss/fpss.php"); // DO NO EDIT THIS LINE ?>
3. You need to fill in the right paths for $siteURL and $sitePath. $siteUrl represents the actual URL of your site. If I were uploading the Frontpage Slideshow package to http://www.mysite.com (at the "root" of the site), the this full URL is what you should write in: $siteUrl = "http://www.mysite.com"
If you were uploading to a subfolder inside your site, you would write something like: $siteUrl = "http://www.mysite.com/somefolder"
You also need to specify the $sitePath value. This is the actual folder path on the server for your site. On servers using the popular cPanel webserver software, this path is usually something like: /home/yourUserName/public_html
If you use mutliple (add-on) domains on your cPanel powered hosting account, then the above path would be something like: /home/yourUserName/public_html/mysite.com
If you use Plesk or any other similar to cPanel software, then configurations are similar. If you ask your hosting company, they will be able to provide you with the "absolute path of your site on the server".
4. Once you fill in those values and provided they are correct, open up your browser and request the example.php page - so you should see something like this: http://www.frontpageslideshow.net/demos/standalone/example.php
Now let's see how to actually create a new slideshow and publish it on your site:
1. Slideshows in the standalone edition of Frontpage Slideshow are basically folders within /fpss/slideshows/ that contain a parameters file, a data file and a folder with the associated slideshow images.
2. Navigate inside the folder "fpss", then "slideshows", copy the folder "demo" (inside the same directory) and rename the copy to something descriptive, e.g. "frontnews". This will act as the folder for your new slideshow. Inside there you will find 2 files and 1 folder as we already mentioned. It is important that you maintain this structure of the slideshow folders. That means you ALWAYS put your slide images inside the "images" folder, your parameters are on the parameters.php file and the slideshow data (contents) are on the data.php file. See a sample structure below:
/fpss |-- /slideshows |-- /yourSlideshowFolder |-- /images |-- data.php |-- parameters.php
You can obviously change "yourSlideshowFolder" to whatever you want and of course have multiple such folders inside /fpss/slideshows/.
3. Assuming you copied the "demo" folder slideshow and renamed it to "frontnews", let's now edit the contents of the slideshow. First you edit the parameters.php file to adjust the slideshow language (English/French - you can add more languages on your own), the slideshow engine, the template and so on. There are detailed instructions on each parameter specified in the parameters.php file. Then you need to edit the data.php file and replace the existing arrays of data with your own. Again the variables on the left side of the arrays are self-explanatory: title, category, link etc. See how the demo data were used to better understand what each variable represents. Once you finish editing these files, you need to upload your own images inside the /fpss/slideshows/frontnews/images/ folder. Assuming you have added the image filenames properly inside data.php, you can go back to the example.php file and replace the $slideshow variable inside the PHP snippet to "frontnews".
Request again the example.php page and you can see your new slideshow in action.
INSTRUCTIONS FOR WORDPRESS, DRUPAL and other CMS users...
When using a CMS like Drupal or WordPress (or any other PHP based CMS), the steps to add Frontpage Slideshow in your template/theme are exactly the same as the above.
- For Drupal users, add the Frontpage Slideshow PHP snippet inside the page.tpl.php file of your theme, located in /themes/yourtheme/
- For WordPress users add the Frontpage Slideshow PHP snippet inside the index.php file of your theme, located in /wp-content/themes/yourtheme/
- In a similar manner you can add Frontpage Slideshow on other popular CMSs like Textpattern, e107, CMS Made Simple, XOOPS, Magento (e-commerce), Zen Cart (e-commerce), osCommerce (e-commerce), Simple Machines Forum (SMF) (forum), phpBB (forum) and many more.
From version 2.0 and after, Frontpage Slideshow "standalone" features a cleaner, easier, Joomla-like way of editing existing slideshow templates or creating your own.
All slideshow templates are represented as folders and located inside /fpss/templates/. For example, the files for the slideshow template called "Movies", which is used on the above demos, are located inside: /fpss/templates/Movies/
There you will generally find:
- a "css" folder containing the template_css.php dynamic CSS file (and other CSS files for IE) controlling the looks of a slideshow template
- an "images" folder with the images used to create the specified template
- a default.php file which is used for the HTML output of the slideshow, containing several PHP variables used to display the elements of slide.
- other files or folders that compliment the slideshow template (e.g. "psd" provides Photoshop versions of graphics used in a slideshow template).
We generally do not recommend editing the default slideshow templates, which are valuable as a reference for your own. It's best to just duplicate the folder of a slideshow template, then edit its contents to create your own, custom template.
To see your new template, you just have to specify the name of its folder inside the parameters.php file of your slideshow.
Frontpage Slideshow "standalone" comes bundled with 2 language files for English and French. The messages contained in those files are used by the slideshow templates to output stuff like "Naviage to...", "Play/Pause slideshow" etc. If you want to add your own language or edit those messages, just duplicate the english.php language file, rename it to your language (e.g. italian.php) and then edit the messages contained in there.
Once you're done, you have to edit the parameters.php file of your slideshow to specify your new language. If the language file was italian.php, we would input "italian" inside the related option in the parameters.php file.
K2 is the popular powerful content extension for Joomla with CCK-like features. It provides an out-of-the box integrated solution featuring rich content forms for items (think of Joomla articles with additional fields for article images, videos, image galleries and attachments), nested-level categories, tags, comments, a system to extend the item base form with additional fields, a powerful plugin API to extend item, category and user forms, ACL, frontend editing, sub-templates and a lot more!
When we choose to have VPS servers (aka virtual machines or VMs for short) instead of dedicated servers, we usually opt for VMware's free ESXi 5 and install Ubuntu Server as the OS for the VPSs we create on top of ESXi 5. It may not be as friendly as some VPS providers like Amazon, Rackspace etc. but you got more control and it's on YOUR hardware (pretty important actually!)...
Now, when you build a VPS on VMware, you start with say 40GBs of hard disk space. You install the OS, setup the server, move the sites on this new server and you're on. But what happens when there's no more room on the server for your site or sites and you need to add more disk space?
If you got a Mac (or Linux box) the process is quite easy. And here it goes...
I bet you never know those existed. Some are still active, some are dead. Check them out...
And in case you don't know where this all started, check Mambo.
A couple of months ago I stumbled upon a website in which the source code included some funky tracking events of Google Analytics (GA) inside the site's links... To be honest, I didn't know at that point Google Analytics could be extended like that, so I dug deeper to learn more.
If you're not an SEO expert using buzzwords like ROI, SEM, CPR etc., you're probably using GA for browsing page views, visitor count, browser percentages etc. Turns out, GA offers at a "basic level" the option to track unique events on your website, e.g. a click on a link or a file download. Which makes statistics viewing way more interesting...