XTDir - Building an advertising catalog for Joomla!.pdf

8/10/2019 XTDir - Building an advertising catalog for Joomla!.pdf

1/42

XTDir PromotedEntries for SobiProBuilding an advertising catalog for Joomla!

Presentation based on Joomla 3, SobiPro 1.1 and XTDir 5

2013-10-01


2/42

In this prese ntation, we are going to show howyou can build an advertising catalog withSobiPro directory and XTDir Promoted Entriessolution.

http://www.extly.com/xtdir-building-an-advertising-catalog-for-joomla.html

More info: XTDir - How to ext end your directoryhttp://www.extly.com/g uides-faq/75-extensions-for-sobipro-document ation/xtdir-for-sobipro.html

Product Page: http://www.extly.com/xtsobipro/sobipro-promoted-entries.htmlSupport: http://support.extly.com

Community Forum Support: http://www.extly.com/forum/index.html

XTDir Pro moted Entries fo r SobiPro
http://www.extly.com/xtsobipro/sobipro-promoted-entries.htmlhttp://support.extly.com/http://www.extly.com/xtsobipro/sobipro-promoted-entries.htmlhttp://www.extly.com/xtsobipro/sobipro-promoted-entries.htmlhttp://www.extly.com/forum/index.htmlhttp://support.extly.com/http://www.extly.com/xtsobipro/sobipro-promoted-entries.htmlhttp://www.extly.com/guides-faq/75-extensions-for-sobipro-documentation/xtdir-for-sobipro.htmlhttp://www.extly.com/xtdir-building-an-advertising-catalog-for-joomla.html


3/42

Prerequisites

XTDir Promoted Entries 5.3, or superior SobiPro 1.1, or superior (recommended) SobiPro 1.0.8 is supported in compatibility

mode Joomla 2.5 /3, or superior MySQL 5.5, or superior (recommended) PHP 5.3, or superior

Prerequisites


4/42

Download and install XTDir Promoted Entriesfor SobiPro

Installation


5/42

1. XTDir updates are installed in the same way

2. Remember to also update SobiPro Apps withthe Update button.

Updates

"Update" buttons in Promoted Entries/Configurationfor Promoted Order App or Promo-InformationField

"Update" button in Configuration/Core Index forRouter App


6/42

Control Panel - Core Index GenerationThe Core Index is the informationstructure require d to control:

Promoted Entries

Search Queries Entries Explorer Statistics

There are three ways to generate theCore Index :

1. Manually2. Cronjob task (recommended)

CLI or Web Script3. On Page Load

To change it, please, check thefollowing Core Index of SobiProEntries slide, in XTDir - How to extend

your directory tutorial .

Step 0
https://docs.google.com/presentation/d/1R0Ijig9G8uKzYOUjYmme13EAUoBXSN1hsH2dyrFcS8E/edit#slide=id.gf3660fa1_039https://docs.google.com/presentation/d/1R0Ijig9G8uKzYOUjYmme13EAUoBXSN1hsH2dyrFcS8E/edit#slide=id.gf3660fa1_039https://docs.google.com/presentation/d/1R0Ijig9G8uKzYOUjYmme13EAUoBXSN1hsH2dyrFcS8E/edit#slide=id.gf3660fa1_039https://docs.google.com/presentation/d/1R0Ijig9G8uKzYOUjYmme13EAUoBXSN1hsH2dyrFcS8E/edit#slide=id.gf3660fa1_039


7/42

Manual Core Index Generation

You can just click in the button.

It's the default mode. You choose when the

index is generated By default, restricted to

1000 entries .

TIP: Buttons for index updating

can be found in managementpages.

Step 0


8/42

Manual Core Index Generation

The Core Index has beensuccessfully generated!

You can check Statistics, Indexinformation, Promoted Entries,and Cache Information in theControl Panel.

Step 0


9/42

The Entries Explorer is themain tool to manage entries.

Navigational access toentries

Links to the SobiPro EntryEdition and Public Entry.

Section and Categoryfilters

Entry State, Approval,and Promotion Status

Ordering management tocontrol Promoted Entries

Entries Explorer


10/42

In SobiPro, there are 3 casesto promote entries:

Search Case: Results

from a search query

Section / CategoryNavigation Case : Entriesshown browsing a Sectionor a Category

Alpha Listing Case ,visiting a Letter of the

Alpha menu

XTDir allows to promote entriesin each of these cases.

Cases


11/42


12/42

In SobiPro, there are 3 casesto promote entries:

Search Case: Results

from a search query

Section / CategoryNavigation Case : Entriesshown browsing a Sectionor a Category

Alpha Listing Case ,visiting a Letter of the

Alpha menu

XTDir allows to promote entriesin each of these cases.

Cases


13/42

The Ordering defines the order of the entries shown and it's determinedacc ording Promotions.

Promotions can have a section or category scope; and there are three typesof promotions:

Manual Promotion , you can define a default value for these entries. E.g.order number 888. You can also manually assign an ordering to specificentries. E.g Neo Electronics, order number 7.

Dynamic Promotion , the ordering is assigned to entries that have aspecific value in a field. E.g. field_premium=option_premium.

Paid Promotion , integrated with SobiPro Paid Fields, you can configurePaypal Notifications (IPN) to receive the payment event and activate theentry with a specific ordering. E.g. Neo Electronics paid for a logo, ordernumber 555; the entry is marked as paid promoted.

NEW User Group Promotions : Check the new tutorial: XTDir - SobiProand PayPlans Membership Management

How it works
https://docs.google.com/presentation/d/1uyCHYYyqlZbYKTzGtNWEWfIsWTTYitVkkcwOlDVN4j4/edit?usp=sharinghttps://docs.google.com/presentation/d/1uyCHYYyqlZbYKTzGtNWEWfIsWTTYitVkkcwOlDVN4j4/edit?usp=sharinghttps://docs.google.com/presentation/d/1uyCHYYyqlZbYKTzGtNWEWfIsWTTYitVkkcwOlDVN4j4/edit?usp=sharing


14/42

How it works

About Manual Promotions: Its mandatory to have a default manualpromotion at section-level to define a baseline ordering.

Example of a common Promotions list: a paid promotion, and two dynamicpromotions.


15/42

How it works : You configure Promotions, or manually assign an ordering to each entry. When theCore Index is generated by the XTDir component, each entry ordering is calculated and assigned(by default, each entry is assigned with ordering 888888). The Promoted Order App is installed andactivated in each SobiPro section. It works on events associated with Search, CategoriesNavigation, and Alpha Listing to change the results default order according to the Promotionsdefinition. Also, the SobiPro Entries Position is updated according the Promotions definitions.

Multi-armed bandit Algorithm: Promoted entries can be sorted by Multi-armed bandit (Top 10%Random, 90% ordered by Hits). The rest of entries are shown in random order. The same algorithmused by Google Adwords.

How it works -Promoted Order App


16/42


17/42

Promo-Information Field, it provides anew read-only field to customize theentry visualization.

For example, in the common/vcard.xsl aclass can be added to customize the visualoutput according the promotype_id (s Ectionor Category), tiertype_id (Manual, Dynamic,P aid), and ordering :

promoted_promoted_promoted_

The field also provides access to other information like: ordering, hits counter, promoentry_id(assigned manual entry Id), and promoorder_id (paid order number) . E.g. promoted_E promoted_Mpromoted_88888. To add a CSS background: #SobiPro .promoted_M { background-color: #FFFF88; }

How it works - Promo-Information Field


18/42

Promo-Information Field, it provides anew read-only field to customize theentry visualization.

For example, in the entry/details.xsl a classcan be added to customize the visual outputaccording the promotype_id (s Ection orCategory), tiertype_id (Manual, Dynamic,P aid), and ordering :

SPDetailspromoted_promoted_promoted_

The field also provides access to other information like: ordering, hits counter, promoentry_id(assigned manual entry Id), and promoorder_id (paid order number) . E.g. promoted_E promoted_Mpromoted_88888. To add a CSS background color: #SobiPro .promoted_88888 { background-color:#FFFF88; }



19/42

To give you a real-world example, in our demo site, we have this template generation. For example,in the entry/vcard.xsl

span6 xtd-vcard thumbnail promoted_ promoted_ promoted_

.


Please, be aware that our demo site also has SP Reviews installed and the promoinformation field isnamed "field_promoinformation".


20/42

To give you a real-world example, in our demo site, we have this template generation. For example,in the entry/details.xsl

SPDetails promoted_ promoted_ promoted_

.


Please, be aware that our demo site also has SP Reviews installed and the promoinformation field isnamed "field_promoinformation".


21/42

Advanced configuration, beyondsimple styling, you can code morecomplex templating.

For example, in the common/vcard.xsl:

Showing the link to entry details only for Paid(P) entries and the administrator UserId (42).



22/42

To build a catalog of promoted geolocatedentries, a Promo-GeoMap Field must beconfigured and installed.

This type of field is similar to SP GeoMapfield , but it shows search results ordered by

priority and location.

1. Entries are shown by priority andlocation.

2. If some entries do not havecoordinates, they are show n after thethe geolocated entries.

How it worksPromo-GeoMap Field
http://sobipro.sigsiu.net/download/fields/374-sp_geomap_fieldhttp://sobipro.sigsiu.net/download/fields/374-sp_geomap_fieldhttp://sobipro.sigsiu.net/download/fields/374-sp_geomap_field


23/42

To build a catalog of promoted geolocatedentries, a Promo-GeoMap Field must beconfigured and installed.

Configuration is similar to SP GeoMap field ,

options are straightforward. The field isintegrated with XTDir Promoted entries tointernally managed priorities.

How it worksPromo-GeoMap Field
http://sobipro.sigsiu.net/download/fields/374-sp_geomap_field


24/42

Promotions can have a section or category scope.

Default Promotion , each entry has assigned the order number888888.

Manual Promotion : You can manually change the ordering tospecific entries. E.g morris.biz, order number 1 (check nextslide).

Manual Promotions


25/42

Step 1: Clik to toggle the manual promotion of a specific entry

Step 2: Manually change the ordering to a specific entry

Manual Promotions


26/42

Manual PromotionsStep 3: Save order

Step 4: Order the entries to check the manual promotion


27/42

Promotions can have a section or category scope. Dynamic Promotion , the ordering is assigned to entries that have a specific

value in a field. E.g. a radio field field_premium with values option-premium or option-lite .

Dynamic Promotions


28/42

Step 1: Go to Promotions and create a new Promotion

Step 2: Fill all required fields.

Dynamic Promotions

1

2

1 - Assign a differentordering (888888 bydefault)

2- SobiPro fields, filled

when entry is created


29/42

Step 3: Order the entries to check promotions

Dynamic Promotions


30/42

Step 4: If the entry is not promoted, check the fields with the SobiPro EntryEdition

Dynamic Promotions


31/42

SobiPro does already s upport paid fiel ds: After a user creates an entry, SobiPro redirects to Paypal

for payment. The missing link: SobiPro does not receive the payment

confirmation and change the entry status.

XTDir provides this feature, based on Paypal InstantPayment Notitication.

To configure IPN, please, check the followingPromoted Ent ries IPN Entries chapter.

Paid Promotions

SobiPro TIP : How to charge for the whole entry
http://sobipro.sigsiu.net/faq/templates-a-design/149-how_to_charge_for_the_whole_entryhttp://localhost/var/www/apps/conversion/tmp/scratch_7/#http://sobipro.sigsiu.net/faq/templates-a-design/149-how_to_charge_for_the_whole_entryhttp://sobipro.sigsiu.net/faq/templates-a-design/149-how_to_charge_for_the_whole_entryhttp://sobipro.sigsiu.net/faq/templates-a-design/149-how_to_charge_for_the_whole_entryhttp://localhost/var/www/apps/conversion/tmp/scratch_7/#


32/42

Promotions can have a section or category scope.

Paid Promotion , integrated with SobiPro Paid Fields,

You can configure Paypal Notifications (IPN) to receive the paymentevent and activate the entry with a specific ordering.E.g. Restaurant Biotopia paid for a logo, order number 555; the entryis marked as paid promoted.

Paid Promotions


33/42

Step 1: Go to Promotions and create a new Promotion

Step 2: Complete all the required fields.

Paid Promotions

1

2

1 - Assign a differentordering (888888 bydefault)

1


34/42

Step 3: Configure Instant Payment Notifications

Paid Promotions

The configuration provides theUrl to configure Paypal IPN .

It provides a way to changethe Entry State and Approvalwhen a payment is notified.

It can also send a mailnotification.

The sandbox mode issupported to test the interface.


35/42


36/42


37/42


38/42

Entries are mostly browsed in SobiProcomponent context. However, to featurepromoted entries, XTDir provides severalwidget modules for entries:

Promoted Entries module Accordion Entries module (Bootstrap

Vertical and Horizontal Layout) Grid of Entries module

Based on: Sigsius Entries Module for SobiPro .

Widgets For Entries
http://sobipro.sigsiu.net/download/modules/162-entries_module


39/42





Widgets For Entries


40/42





Widgets For Entries


41/42

Widgets modules share a similarconfiguration.

1. Select section

2. Select module template

It can be any of the packaged templates,or you can create your own (directorycomponents/com_sobipro/usr/templates/f ront/modules). Templates follow SobiProXSLT practices.

3. Select order field

You can select the PromoInformationfield.

Widgets For Entries - Config


42/42

One last word

We love your feedba ck , it's our way toimprove.

This presentation was created with your help.

Please post a rating and a review at the #JED

It really helps ;-)More info: XTDir - How to e xtend your directoryhttp://www.extly.com/guides-faq/75-extensions-for-sobipro-documentation/xtdir-for-sobipro.html

Su pport: http://suppo rt.extly.comCommunity Forum Support: http://www.extly.com/forum/index .html

Twitter @extly
http://www.twitter.com/extlyhttps://www.facebook.com/Extlyhttp://support.extly.com/http://support.extly.com/http://www.extly.com/guides-faq/75-extensions-for-sobipro-documentation/xtdir-for-sobipro.htmlhttp://www.extly.com/guides-faq/75-extensions-for-sobipro-documentation/xtdir-for-sobipro.htmlhttps://www.facebook.com/Extlyhttp://www.twitter.com/extlyhttp://www.extly.com/forum/index.htmlhttp://support.extly.com/http://www.extly.com/guides-faq/75-extensions-for-sobipro-documentation/xtdir-for-sobipro.html

Documents

XTDir - Building an advertising catalog for Joomla!.pdf