Advertisements
Contents
Related sub-modules
Banking - Currencies, Users - Users, Marketplace - Image viewer (Sub-module not found in Cyclos), Marketplace - Images (Sub-module not found in Cyclos), Messaging - Message section (Sub-module not found in Cyclos), Marketplace - Ad question section (Sub-module not found in Cyclos), Marketplace - Fields, Users - Products and Marketplace - Categories.
Description
This specification is very extensive. It is used to create, edit, view and delete normal advertisements and webshop advertisements. Trough normal advertisements users can offer goods and service to other users. Webshop advertisements are a more advanced type of advertisements that allows users to have a complete webshop with stock management, delivery methods, and the ability for buyers to put products into a shopping cart.
Business rules
- The maximum number of advertisements published or scheduled by user is defined by a configuration setting in his products.
- The maximum number of advertisements's images is defined by a configuration setting in his products.
- If a user has multiple products always the largest amount is taken.
- An advertisement can be linked to a specific address (visible).
- Advertisements can be configured to require a user manager authorization to be published.
Advertisements without authorization
The logged user can manage the simple ads of a member if he/she:
- Is an admin that manages the member and has permission to manage simple ads ( Advertisements - Manage).
- Is the member itself and has "my ads enabled" permission ( Enable advertisements).
- Is the broker of the member and has permission to manage simple ads ( Advertisements - Manage).
- Is an operator of the member and has permission to manage simple ads ( Advertisements - Manage).
The logged user can manage the webshop ads of a member if he/she:
- Is an admin that manages the member and has permission to manage webshop ads ( Web shop - Manage).
- Is the member itself and has "my webshop enabled" permission ( Enable web shop ads).
- Is the broker of the member and has permission to manage webshop ads ( Web shop - Manage).
- Is an operator of the member and has permission to manage webshop ads ( Web shop - Manage).
The possibles status of an advertisement are:
- Published - It's currently available.
- Hidden - It won't appear in search results.
- Scheduled - It will become available in a future date.
- Expired - It's no longer available.
- Disabled - The ad is no longer available because the owner lost access to the currency of the ad. Disabled ads don't appear in search results unless explicitly requested (via a status filter).
Advertisements with authorization
- All the above permissions and statuses for advertisements are still valid for advertisements with authorization but some other rules are added:
The possibles status of an advertisement with authorization are:
- Draft - Only visible to the owner, left in this status to be able to complete the ad later.
- Pending - The ad is pending for authorization
- Published - It's currently available.
- Hidden - It won't appear in search results.
- Scheduled - It will become available in a future date.
- Expired - It's no longer available.
- Disabled - The ad is no longer available because the owner lost access to the currency of the ad. Disabled ads don't appear in search results unless explicitly requested (via a status filter).
Simple ads will require authorization only if the "Ads require authorization" option is selected at the products
Webshop ads will require authorization only if the "Web shop ads require authorization" option is selected at the products
Owner rules
- The owner can always edit a Draft ad.
- The owner can submit the ad for authorization by selecting the option "Submit for authorization" when creating or editing.
- The owner cannot edit a pending ad
- Once the ad is published the owner can change the ad back to draft status, action that will require a subsequent authorization to publish the ad.
- The owner can always hide/unhide a published ad, this action doesn't require an authorization process.
User manager rules when having the manage pending ads ( Pending ads - Manage, User webshop pending ads - Manage)
- Can create an ad and it will be directly published. He cannot save it as draft.
- Can set an active ad as draft. This ad will disappear from the search since admin/broker can't view draft ads of managed users.
- Can authorize a pending ad. This action will enable the ad to be published when it reaches the publication period.
- Can reject a pending ad. This action will leave the ad as draft disappearing from the admin/broker search immediately.
- When an ad is rejected or set as draft a comment can be entered. The comment will only be shown to the owner.
- Can hide or unhide an ad.
Access
The menu item "Marketplace" is only shown if the user has a member or broker product with at least one category set selected under one of the following options:
- Advertisements: Visible ad category sets (member).
- Advertisements: Visible web shop category sets (member).
- User data: Visible ad category sets (broker).
- User data: Visible web shop category sets (broker).
The menu item "User management > Advertisements" is only shown if the user has an admin product with at least one category set selected under one of the following options:
- User data: Visible ad category sets (admin).
- User data: Visible web shop category sets (admin).
The menu item "Marketplace > Web shop" is only shown if the user has a member product with at least one category set selected under:
- Advertisements: Publish web shop advertisements (member).
Notifications
- See ad interests
- See shopping cart
- See ad questions
- When an advertisement expires a notification is send.
- Notification: Advertisement expired.
- Hyperlink: links to the expired advertisements.
- Permission: Enable advertisements or Enable web shop ads.
Page: Advertisments
Security
Roles:
- All
View permission:
- Enable advertisements (member editing his own ads)
- Advertisements - View, View advertisements (admin or broker viewing a member´s ad or an operator viewing his/her member ad)
Other permissions:
- Advertisements - Manage (admin or broker editing a member´s ad or an operator editing his/her member ad)
Comments:
- The result list shows the simple advertisements of an specific user.
- A user can view his ads trough the the tab "my ads", brokers and administrators can view this trough user actions.
Page sections
Search page (filters)
Field | Types | Rules |
Keywords | Text | Word(s) to be searched on fields "Description" or "Title" |
Category set | Single selection |
|
Statuses | Multi selection | Selection field with following options:
|
New | Multi action button |
|
Search | Action button | Execute the search.
|
Search result (list)
Field | Types | Rules |
Picture | Image | Thumbnail of the first picture of the ad. |
Description | Text (read only) | Composed as follows:
|
Price | Text (read only) | Stipulated price, the currency prefix and suffix are displayed. |
Remove | Icon | Removes this ad. For removing an simple ad at least one this permissions are mandatory:
|
"Row" | "Row" | Clicking on a row opens the preview page of the selected ad (#Page: View advertisement). |
Page: Web Shop
Security
Roles:
- All
View permission:
- Enable web shop ads (member editing his own ads)
- Web shop - View, View web shop (admin or broker viewing a member´s ad or an operator viewing his/her member ad)
Other permissions:
- Web shop - Manage (admin or broker editing a member´s ad or an operator editing his/her member ad)
Comments:
- The result list shows all webshop ads of an specific user.
- A user can view his webshop ads trough the tab "my webshop ads". Brokers and administrators can view this trough user actions.
Page sections
Search page (filters)
Field | Types | Rules |
Keywords | Text | Word(s) to be searched on fields "Description" or "Title". |
Category set | Single selection |
|
Product number | Text | Product number to be searched. |
Statuses | Multi selection | Selection field with following options:
|
New | Multi action button |
|
Search | Action button | Execute the search. |
Search result (list)
Field | Types | Rules |
Picture | Image | Thumbnail of the first picture of the web shop ad. |
Description | Text (read only) | Composed as follows:
|
Price | Text (read only) | Stipulated price, the currency prefix and suffix are displayed. |
In stock | Text (read only) |
Quantity of the items in stock:
|
Remove | Icon |
Removes this web shop ad. For removing an web shop ad at least one this permissions are mandatory:
|
"Row" | "Row" | Clicking on a row opens the preview page of the selected ad (#Page: View advertisement). |
Page: Edit advertisements
Security
Roles:
- Admin
- Broker
- Member
- Operator
View permission:
- Enable advertisements (member editing his own ads)
Other permissions:
- Advertisements - Manage (admin or broker editing a member´s ad or an operator editing his/her member ad)
Comments:
- Only simple ads are shown here.
- Used to create and to edit simple ads
Page sections
Details page
Fields | Types | Rules |
Navigation area | Text (read only) | This is only shown if the edited ad has status disabled. A warning is then shown, stating: This ad has the disabled status and cannot be viewed by other users. In order to activate the add please chose a price and currency and Save the ad again. |
Title | Text |
|
Category | Single select |
|
Price | Currency amount |
|
Publication period | Period |
|
Hidden | Boolean |
|
Promotional price | Currency amount |
|
Promotional period | Period |
|
Description | Rich text |
|
Show on map | Single selection | Allows to link an advertisment to one or more addresses of the logged user.
|
Custom fields | Depend on custom field |
|
Creation date | Text (read only) | The date the ad was created. |
Owner | Link | Link to user profile.
|
Images | Link | Link with text 'Add image' and next to that the text '(remove)'. Clicking on Add image will open the file picker dialog. One or more images can be selected. The images will be listed in a list using the component that is used to add users when sending a message (be aware that this component has an delete option for each item in the list, this should work in this case to). The 'Add image' can remain in the front (left) of the image list. It will have to look like this. Be aware that that the Add image option and the list only shows up when creating an ad. When editing an ad the images are managed via the Image tab. |
Save | Action button | Clicking on this button will save the add, the user will be taken to the view only page of the ad (view advertisement page). |
Save and insert new | Action button | This actions will save the add and present the ad details page of a new add. The new ad comes with the category and the publication period (if defined) pre selected. |
Image manager - Visible as a tab if the user is editing an advertisement (not visible upon creation), only shown when the user is allowed to have more than 0 images per advertisement (defined in his product). The save button has the same behavior as the save button on this page. |
Page: Edit webshop advertisments
Security
Roles:
- Admin
- Broker
- Member
- Operator
View permission:
- Enable web shop ads (member editing his own ads)
Other permissions:
- Web shop - Manage (admin or broker editing a member´s ad or an operator editing his/her member ad)
Comments:
- Only webshop ads are shown here.
- Used to create and to edit webshop ads.
Page sections
Details page
Fields | Types | Rules |
Navigation area | Text (read only) | This is only shown if the edited ad has status disabled. A warning is then shown, stating: This ad has the disabled status and cannot be viewed by other users. In order to activate the add please chose a price and currency and Save the ad again. |
Title | Text |
|
Category | Single select |
|
Price | Currency amount |
|
Publication period | Period |
If the value of "default ad publication period" is defined on owner´s group settings:
|
Hidden | Boolean |
|
Promotional price | Currency amount |
|
Promotional period | Period |
|
Description | Rich text |
|
Show on map | Single selection | Allows to link an advertisment to one or more addresses of the logged user.
|
Stock type | Radio buttons |
Possible values:
|
Allow decimal quantity | Boolean |
|
In stock quantity | Integer or positive decimal |
|
Low stock notification | Integer or positive decimal |
|
Maximum allowed in cart | Integer or positive decimal |
|
Minimum allowed in cart | Integer or positive decimal |
|
Product number | Text |
|
Delivery method | Check boxes |
|
Custom fields | Depend on custom field |
|
Save | Action button | Clicking on this button will save the ad, the user will be taken to the view only page of the ad (view advertisement page). |
Save and add images | Action button |
|
Image manager - Visible as a tab if the user is editing an advertisement (not visible upon creation), only shown when the user is allowed to have more than 0 images per advertisement (defined in his product). |
Page: Search ads
Security
Roles:
- All
View permission:
Other permissions:
- None
Comments:
- The search returns simple advertisements and webshop products.
Page sections
Search page (filters)
Fields | Types | Rules |
Keywords | Text |
|
Category | Link | Shows the category of the product the user looks for.
|
Distance | Checkbox | Allows to search for advertisments which are located ate adresses within a defined radius of one of the addresses of the logged user. This search filter is especially handy in the search result view "Map" in order to gain an overview of closed-by advertisements.
|
With images only | Boolean |
|
Statuses | Multi selection | Filters ads on specific status.
Options:
|
Price range | Currency range |
|
Published since | Time interval |
|
Custom fields | Depend on custom field |
|
User custom fields | Depend on custom field | All the available user custom fields for search. In order to make a custom field available for search it must configured in the corresponding product. See ( products: User custom fields for users search and User custom fields for ads search) for more details.
When a value is specified in this kind of fields take into account the following:
|
Advanced | Action button |
|
Simple | Action button |
|
Browse categories | Action button |
|
Latest ads | Action button |
|
Search | Action button |
|
Browse categories panel | ||
Panel that lists the categories in a hierarchical form. Clicking on a category filters the ads of that category and executes the search using the search filters listed above. The category set selected in the "search page (filters)" defines which categories are displayed See browse hierarchies widget. | ||
Breadcrumb of categories | ||
The breadcrumb is shown at the moment that a category is selected on the "Browse categories panel". From then on the selected category is used as a filter. There are two ways to select another category. 1) Clicking on a parent category at the breadcrumb itself. 2) Clicking on the "Browse categories" button and selecting another category. |
Search result (list *)
* The result list can be shown in "Tiled images", "List with images" or "Plain list" style (the default is set in the configuration). The results can be sorted by "Relevance" (an algorithm determines how relevant the result is to the search query, see http://lucene.apache.org/core/3_6_2/scoring.html), "Creation date", "Alphabetically ascending" and "Alphabetically descending".
Fields | Types | Rules |
Picture | Image |
|
Description | Text (read only) | Composed as follows:
|
Price | Text (read only) |
|
Status | Text (read only) |
|
In stock | Text (read only) |
|
Buy now | Icon |
|
"Row" | "Row" | Clicking on a row opens the preview page of the selected ad (#Page: View advertisement). |
Page: Last ads
Security
Roles:
- Admin
- Broker
- Member
- Operator
View permission:
- None
Other permissions:
- None
Comments:
- Show only active ads.
- Shown only ads of the category set selected in the search page.
- Clicking on a result will take to view advertisements page.
Page sections
Search page (filters)
Field | Types | Rules |
Back to advertisement search | Action button | Opens the search advertisement page with "browse categories" panel. |
Search result (list)
Fields | Types | Rules |
Picture | Image |
|
Description | Text (read only) | Composed as follows:
|
Price | Text (read only) |
|
Status | Text (read only) |
|
In stock | Text (read only) |
|
Buy now | Icon |
|
Page: View advertisement
Security
Roles:
- All
View permission:
- None
Other permissions:
- None
Comments:
- When user clicks in send message the title is automatic fulfilled with product code/name
- This specification is used for both simple ads and webshop ads
Page sections
Details page
Fields | Types | Rules |
Image | Image | The main product image (medium thumbnail):
|
Title | Text (read only) |
|
Category set | Text (read only) |
|
Category | Text (read only) |
|
Price | Text (read only) |
|
Promotional price | Text (read only) |
|
Owner | Hyperlink |
|
Items in stock | Text (read only) |
|
Delivery method | Text (read only) |
|
Product number | Text (read only) |
|
Minimum allowed in cart | Text (read only) |
|
Maximum allowed in cart | Text (read only) |
|
Description | Text (read only) |
|
Send a personal message | Action button |
|
Send a message from system | Action button |
|
Ask a question about this product | Action button |
|
View questions | Action button | Takes to questions and answers section.
|
Buy now | Action button |
|
Edit | Action button |
|
Image viewer - this component appears when the image is clicked or when there are multiple images attached to the ad. | ||
Message popup - this component appears when "Send a personal message" or "Send a message from system" is clicked and used to send a message to the seller. | ||
Question popup - this component appears when "Ask a question about this product" is clicked and used to ask a question about an ad to the seller. | ||
Ad question section - this component appears when there are question about an ad, this component show these questions. |