DEVON - Model Agency Directory

Complete Model Agency Solution WordPress theme

• latest update: 06/9/2019
• by: Sandi Winter

Build your Model Agency Portal in WordPress

Minimal Requirements:

• PHP version 5.6 or newer
• MySQL (4.1+)
• WordPress 4+

Quick installation with WordPress already installed:

1. You should have WordPress 4.x installed ( https://wordpress.org/ ), best if you have clean installation.
2. Upload devon_theme.zip on server via cpanel file manager to folder "wp-content/themes" and extract directly on server or just extract in localhost server
3. Open your WordPress Administration, click on Appearance and Activate devon theme
4. Click on install theme and follow installation procedure, just clicking "next".

Cpanel screens:

2. Upload devon_theme.zip on server via cpanel file manager to folder "wp-content/themes"

3. Activate theme in your WordPress admin dashboard:

4. Install theme, plugins and demo content:

Plugin support custom register/login page, users registered there will automatically become agents/own.

Visitors can also quick submit listings even without registration proccess, but if user is not registered account will be automatically created (require only email).

For other account types by default quick submission is disabled, but you can enable user type transformation for subscriber in Admin->Listings->Settings

Custom register page can be defined in:

Quick submission

In Admin->Listings->Settings you can define Quick submission page

This page can be used for quick submission (require to populate only required fields and defined fields by administrator). Visitors can submit listings even without registration proccess, but if user is not registered account will be automatically created (require only email).

You can add this page link into your menu if you wish.

You can also add nice quick submission button widget to sidebar, example:

Example of usage:

Admin/Agent/Regular submission

In Admin (Dashboard)->Listings admins/agents can add llistings:

Our Theme support many templates for specific usage, like profile, results, listing preview, content, contact, news.

With default demo installation everything will be configured nicely and you can check yourself in admin.

Example usage:

Templates are build based on WordPress standard widgets, this can be edited in widgets editor or customizer in WordPress, and primary visual builder elementor elements example:

Plugin support categories, and based on categories you can define visible fields

This visible fields dependent on categories will have effect on listing submission and search form

To enable this feature go to Admin->Listings->Settings->Check "Show categories"->Save

In Admin->Listings->Settings you can also check "Search in sub-categories", this means that when searching, results from subcategories also will be visible in results

You can manage categories in Admin->Listings->Categories

When edit category, you can manage visible fields:

Map pin icons

Map pin icons are also related to categories, example:

Automatic locations

Plugin support automatic locations based on user populated fields like address, country, city, and auto search based on this data with help from google api to detect coordinates.

Search example with google api suggestions, and after that detect coordinates:

Manual strict locations

You can also additionaly add manual strict locations like Country->City->Neighbourhood

To enable this feature go to Admin->Listings->Settings->Check "Show locations"->Save

Then in Admin->Listings->Locations add location tree like example:

You can also add multiple values at once, example:

Location search field can be also added in Admin->Locations->Search form

Now you can select location on listing submission form

After that if you don't want to use custom Country or CIty field you can remove them

SVG Region Map

You can also automatically build locations based on SVG map data, example:

Guide to add amcharts SVG maps: http://listing-themes.com/nexos-wp/docs/img/desc2/svg_map_wp.pdf

Complete plugin is organized based on Fields, so listing details are collected from fields.

You can manage this fields (Drag & drop) to reorder, edit, delete in Admin->Listings->Fields

Some fields are RED LOCKED, this means that we doesn't allow to remove them. We doesn't allow this because field is importand by design/functionality for web or for mobile api. But in any case you can rename it suggesting for some similar purpose.

Please don't change/remove category fields type, Fields not in categories are not visible automatically on listing preview, only specific defined field like description or content are visible, so don't  remove/change all categories!

If you want to customize listing preview HTML, related file:

wp-content/themes/devon/SW_Win_Classified/views/frontend/listingpreview.php

Example modification in WordPress dashboard, to add new field above description in listing preview:

In this example 87 is new field ID, found in admin->listings->fields

Search form is designed as widget or VIsual Composer element. Every search result also must content primary search form to work properly.

When user first click on search form it's redirected to results page ( defined in Admin->Listings->Settings )

Search form contains listing fields, and can be visually generated in Admin->Listings->Search form

For some searching based on numbers from/to you need to make fields searchable and all new added listing will be searchable by this field, example, when edit non-searchable field:

You can also transform INPUTBOX/INTEGER into dropdown on search form, in some cases like Price selection.

Example solution:

Results page ( defined in Admin->Listings->Settings ) containe result items

Result item contain listing fields, and can be visually generated in Admin->Listings->Result item

If you want some HTML changes on result item or result page its located in:

wp-content\themes\devon\SW_Win_Classified\views\frontend\resultspage.php

Regular plugin version is located in, but template version have priority if you using template related:

wp-content\plugins\SW_Win_Classified\codeigniter\application\views\frontend\resultspage.php

If you want to customize infowindow on map then file:

wp-content\themes\devon\SW_Win_Classified\views\frontend\infowindow.php

Regular plugin version is located in, but template version have priority if you using template related:

wp-content\plugins\SW_Win_Classified\codeigniter\application\views\frontend\infowindow.php

In WordPress you can change langauge here:

Admin->Settings->General->Site Language

For translations we suggest Loco Translate plugin

Localization files can be found in: wp-content\plugins\SW_Win_Classified\locale

Elementor Blocks for DEVON

and for theme: wp-content\themes\devon\locale

If some words missing there, try to sync template file, guide:

Video GIF example for sync first template and after that language file (so 2 times for theme and plugin):

First template file must be synced + saved
Then also language file synced + saved

Also some fields are dynamically generated, like search form, submission fields and similar, this can be translated in: Admin->Listings->Fields->Edit all and change name, values

Categories for example in Admin->Listings-Categories

Locations for example in Admin->Listings-Locations

TRANSLATION SHARING:

If you translate theme into your langauge, will be nice if you can share it with us, to share it please zip folders:

wp-content\themes\devon\locale

wp-content\plugins\SW_Win_Classified\locale

and send it to: support@geniuscript.com

thank you very much!

Our plugin also support commercial WPML if you will need it, WPML require additional page for each langauge.

1. Buy and Download CMS version here: https://wpml.org/

2. Install WPML in usual regular way (default order of languages, because in our plugin first language in order is also default) and add new pages for each langauge and page:

3. You should add language switcher widget

4. To translate regular translation words use Loco Translate plugin as described in previous section, WPML also support some additional tools:

5. Translate fields:

6. Translate categories

7. Translate listings

8. Some translate settings

Multilanguage required - In dashboard required fields must be populated for all languages

If Multilanguage required will be unchecked, then fields will be copied or auto translated

You can provide Google Translate API key (not free) for best Google translations, in other case MyMemory free api will be used.

Instructions to get API key: https://cloud.google.com/translate/v2/getting_started

Limit cURL calls is there because some servers doesn't allow unlimited calls for translations (each input field translation require one call), here can be limited and other translations will be just copied.

On quick submission user need to populate only default language

As any other WordPress plugin or theme, our also contain lot of Widgets which can be added to some predefined places in specific template

Usually it's right sidebar or footer. For example search form fit nicely right sidebat, map results listing footer etc.

In Admin->Appearance->Widgets you can drag & drop existing widgets (prefixed with SW) to such predefined places in your template

Our theme support standard widget placeholders, some are default or based on template used

As any other WordPress plugin, our also contain lot of Shortcodes which can be added to pages

Shortcodes example

[swlisting id="xx"]

Single listing based on listing id "xx", listing id is numeric value and can be found in Admin->Listings, column #

[swlistings text_criteria="xx" show_featured="xx" num_listings="xx" agent_id="xx"]

Multiple listings with filter options

text_criteria can be any text for search, example "luxury"

show_featured can be ALSO_FEATURED or ONLY_FEATURED or ONLY_FEATURED

num_listings is number of listings limitation

agent_id can be user ID or user email

[swagent id="xx"]

Single agent based on user ID "xx", or user email

[swagents text_criteria="" num_listings="xx"]

Multiple agents with filter options

text_criteria can be any text for search, example "luxury"

num_listings is number of listings limitation

[swmap address="xx" content="xx"]

Show map with pin on specific address and with specific content on infowindow

[swmaplistings text_criteria="xx" num_listings="xx" agent_id="xx"]

Multiple listings with filter options, visible on map

text_criteria can be any text for search, example "luxury"

num_listings is number of listings limitation

agent_id can be user ID or user email

[swfeaturedlistings]

Show featured listings only

[swcontact email="xx"]

Show contact form

[swprimarysearch] - Show primary search form 

[swsecondarysearch] - Show secondary search form 

Special content feature

[swcontent] - This code will be replaced with plugin content if available in text 

Search links

If you need link to specific search query, you can use query tags like example:

http://geniuscript.com/replugin/results-page/?search_what=cestica

For more example you can try search directly on your website and check URL bar

Listing Tags

Plugin also support something similar to tags, so you can add new page, set it for page tags (Admin->Listings->Settings->Tags page) and then based on page permalink create tag links as example on screenshot:

Mobile api

Mobile api is also supported for mobile app templates:

Android: https://codecanyon.net/item/real-estate-android-app/14991247

iOS: http://iwinter.com.hr/support/?p=7480

In mobile app code you should define urls to access api like that:

for android version example:

<string name="script_url">http://your-website.com/wp-content/plugins/SW_Win_Classified/codeigniter/mobileapi.php/</string>
<string name="files_url">http://your-website.com/wp-content/uploads/sw_win/files/</string>
<string name="thumbnails_url">http://your-website.com/wp-content/uploads/sw_win/files/thumbnail/</string>

for ios version example:

Of course, replace your-website.com with your real website domain and run first url from browser to check if works properly.

Only quick search, advanced search, near listings features works for now. Favourites, Login, Register, Quick submission, Taking photos planned in future and for now must be disabled in mobile app config file.

For multilanguage:

In file: wp-content\plugins\SW_Win_Classified\codeigniter\application\config\mobileapp_config.php, also populate $config['lang_config'] array if you using more then one langauge (example available in file)

JSON API is compatible with our regular script version: http://real-estate.iwinter.com.hr/documentation/#!/public_api_rss

Facebook login

You should create app in facebook for facebook login functionality:

Create app by this guide: http://iwinter.com.hr/support/?p=552

Then enter parameters in Admin->Listings->Settings

Google reCaptcha SPAM prevention

Get your recaptcha keys on page: https://www.google.com/recaptcha

Then enter parameters in Admin->Listings->Settings

You can export all users email in Admin->Tools->MailChimp, this can be used in mailchimp and also some another apps to import and build newslatter campaign

Related to templates:

For demo purposes we using Twenty Sixteen and Total, but tested also with:

Twenty Seventeen,Twenty Sixteen,Twenty Fifteen,Twenty Fourteen and Total

CSS, theme related:

If you want something very special, you can add own css changes, this require basic css knowledge.

You can use firefox or chrome developer console, in firefox can be oopened with CTRL+SHIFT+K

then locate what you want to change

and add custom css into standard WordPress customizer, example:

CSS, plugin related:

If you need to customize some styles, change it in:

wp-content\plugins\SW_Win_Classified\assets\css\style.css

Or even better in your theme custom css file.

For some CSS customizations we suggesting to use Firefox and Developer Tools (CTRL+Shift+K)

PHP related:

Our plugin is based on Codeigniter MVC arhitecture and Bootstrap on frontend.

https://www.codeigniter.com/user_guide/

MVC means:

M = Models (generate database queries)

V = View, contains mostly HTML

C = Controller contains mostly logic, transfer data from M to V

How to detect in which file is something:

We organized WordPress URL in this way, when url looks like:

wp-admin/admin.php?page=listing_manage

This means listing is controller in admin, and manage is method in this controller

Controller code can be found in: wp-content\plugins\SW_Win_Classified\codeigniter\application\controllers\Listing.php

View (HTML) code can be found in: wp-content\plugins\SW_Win_Classified\codeigniter\application\views\admin\listing\manage.php

When we using URL like this:

wp-admin/admin.php?page=currency_manage&function=addcurrency&id=32

This means currency is controller in admin, and addcurrency is method called in this controller

Controller code can be found in: wp-content\plugins\SW_Win_Classified\codeigniter\application\controllers\Currency.php

View (HTML) code can be found in: wp-content\plugins\SW_Win_Classified\codeigniter\application\views\admin\currency\addcurrency.php

Dashboard menus:

It's defined in file: sw_win_options.php

Widget controller:

wp-content\plugins\SW_Win_Classified\codeigniter\application\controllers\Widgets.php

Widget name represents controller method

Widget views (HTML):

Can be found in: wp-content\plugins\SW_Win_Classified\codeigniter\application\views\widgets

Shortcode controller:

wp-content\plugins\SW_Win_Classified\codeigniter\application\controllers\Shortcodes.php

Shortcode name represents controller method

Shortcode views (HTML):

Can be found in: wp-content\plugins\SW_Win_Classified\codeigniter\application\views\shortcodes

Custom pages defined in Admin->Listings->Settings:

Controller is: wp-content\plugins\SW_Win_Classified\codeigniter\application\controllers\frontend.php

Views can be found in: wp-content\plugins\SW_Win_Classified\codeigniter\application\views\frontend

(This is related to VIsual Listings plugin only)

From v1.4 plugin we implemented advance theme support.

Please reading custom coding section before that.

So you can add custom HTML for all view files based on your theme requirements.

Structure is same as in plugin folder, but here it's located in theme folder, example:

Additionaly we added some custom functions support for themes like demo installation.

By default this functions are implemented in file:

wp-content\plugins\SW_Win_Classified\codeigniter\application\models\Install_m.php

Example how we run this function:

You can define this functions in functions.php template file or similar where you saving such functions usually.

Example functions, we suggesting custom install.php file for such functions:

We have special website made for support, frequency questions for customizations, guides for basic CSS/HTML, tips & tricks etc.: http://iwinter.com.hr/support

Regarding hosting providers, we testing on:

How to change homepage?

Admin->settings->reading

PDF export doesn't work?

You should not have website locked with password, PDF export doesn't work then

WordPress.com issues with install demo content on premium account:

WordPress.com doesn’t allow you to upload your own themes (you’re stuck with what’s available for free or in their marketplace) so in order to use any of the awesome themes on marketplace you’ll need to get yourself a self-hosted installation of WordPress.

We will try to make as most features possible compatible, but they have so many limitations for plugins that is not suggested to use it.

Use cheap and good hosting suggested in above section instead.

Installation failed with message: The package could not be installed. The theme is missing the style.css stylesheet. ?

You using wrong file for theme installation, open this file, maybe you have inside devon_theme.zip , use this devon_theme.zip file instead.

Link has expired message in WordPress?

Check this articles:

https://superpctricks.com/the-link-you-followed-has-expired-wordpress-error/

https://docs.presscustomizr.com/article/333-how-to-fix-the-link-you-followed-has-expired-in-wordpress

So this usually happen because of small upload_max_size configuration on server and is easy to solve. You can also extract theme directly on server cpanel file manager into folder "wp-content\themes\" instead of uploading via dashboard.

This sometimes happen in WordPress, not relate to theme, Clear your browser cache and cookies or use another browser / PC.

Also use clean latest WordPress version, because some third parity plugins can also cause that.

You receiving "Sorry you are not allowed to access this page" ?

Check above, similar to link has expired.

Also check your PHP version, must be min. 5.6 or above

How to import data to plugin/theme?

Plugin "Wp all import" can be used for import any csv or xml file, with nice visual fields mapping. If you need cronjob support you can purchase pro version but for basic imports it's free. http://www.wpallimport.com/

You need to download and activate it from wp plugin repository, Admin->Plugins->Add New

You also need to install and activate our plugin Winter Listings WpAllImport

After that follow standard wpallimport proceddure, example for start:

Multiple categories can be inserted this way:

How to export data?

Plugin "Wp all export" can be used for export any csv or xml file, with nice visual fields mapping.

http://www.wpallimport.com/export/

Guide to use:

You need to download and activate it from wp plugin repository, Admin->Plugins->Add New

You also need to install and activate our plugin Winter Listings WpAllImport

After that you need to prepare listings for export, screen:

After that you can export as usual with wp all exports

You want to enable page offline?

You can use any plugin for this purpose, like: https://wordpress.org/plugins/site-offline/

How to change currency?

Admin->Listings->Fields->Edit price for example and change prefix/suffix

In Admin->Currencies you can also change it on currency conversion widgets

Google maps stop working?

We added open street maps support as alternative and can be activated in Admin->Listings->Settings

Google maps become commercial, paid services and actually not cheap,

All details available here: http://iwinter.com.hr/support/?p=17200

Basically Admin->Listings->Settings and enter your own google maps api key

You add listing but it's not available on page?

Listing must be activated by admin or paid services to become visible.

Admin->Listings->Edit wanted->check if it's activated

You want to disable word Any in search forms?

Some coding required, example:

Similar way yo ucan customize any other field.

Receiving error, Call to undefined function get_header() in index.php... ?

You don't have WordPress installed. This is WordPress theme so WordPress is required for installation.

function get_header is part of WordPress and if you don't have it installed so is expected that will be undefined.
All details about that function: https://codex.wordpress.org/Function_Reference/get_header

Solution 1:

1. Install WordPress by some regular WordPress installation guides.

2. Install this WordPress theme by docs guide.

After changes on website you still see old website version on mobile or desktop and happens even after clearing browser cache?

Server caching causing this.

You need to contact your hosting provider or server admin to disable server caching, also WordPress plugins for caching can cause this, sometimes hosting provider add that for you to reduce server usage, specially on cheap reseller or shared accounts.

Example cache detection with console: https://prnt.sc/kf12x5

Some links examples and solutions:

https://support.wptouch.com/article/1466-endurance-page-cache

https://github.com/bluehost/endurance-page-cache/issues/15

https://github.com/bluehost/endurance-page-cache/issues/27

Issue with sending emails?

Some servers have trouble with that and you need to use SMTP feature.

We tested this one and works fine with our plugins: https://wordpress.org/plugins/wp-mail-smtp/

Translated fields not visible?

You must translate also categories where this fields belong, if category is not translated, then all fields inside this category will not be visible.

Follow complete translation guide, please don't skip steps.

Your field width on submission to small or want to change?

You have issue like this?

Solution based on bootstrap columns/grid system:

if you want based on category or location you can use in text criteria: location_id_1 or category_id_1 where 1 is ID number example

How to disable report listing or some other feature?

Some features are added as plugins so you basically need to deactivate plugin, example:

And some in WordPress customizer widget or settings, so check in Customizer

I receiving message when adding listing  "The Title field cannot exceed 20 characters in length. (English)" ?

admin->listings->fields->edit title and change max length to wanted

I've used the following files and services as listed:

1. WordPress
2. jQuery
3. Bootstrap
4. The Documenter

Thank you so much for purchasing this template. We will do our best to help you if you have any questions or issue relating to this plugin.