Listings within the Real Estate package are stored as standard concrete5 pages, using the new Real Estate Listing page type. The details of each listing is stored as page attributes (aka page properties). After installing the package a new Real-Estate Listings section will be added to your dashboard. From here you can search and create new listings. You can also use concrete5's default dashboard tools to manage your listings, such as the sitemap, or try using the page search and filter your results to show only the Real Estate Listing page type. Through either interface you'll have access to each listing's page permissions and properties
In newer versions of concrete5 will take advantage of the concrete5 dashboard's composer page creation tool. To use this though, make sure you have at least one "Real Estate Listings" (plural) page installed somewhere on your site for the listing pages to be added under! You can also create a new real estate listing in the same way that you create any other concrete5 page. Just click "Add Page", select the "Real Estate Listing" page type, and fill out the displayed page properties.
Note that generally you'll want to add all of your listing pages as siblings, under a common parent page, such as the "listings" page that's installed by default (if you choose to install the sample data). It is required that you use the "Real Estate Listings" page type for this parent page.
You can make your listings searchable with the included Real Estate Search block. This block allows you to split the display of the search form and the results. For example, you can add the real estate search block with just the search mode enabled to your homepage, then you can specify a target to have the results show up on another page. That resulting page must have another instance of the Real Estate Search block installed on it, and should be set to display the results. Alternativity, you could install the search form in a page's sidebar, and the results in the main body area. You can add additional searchable properties when editing the block. Just click the button with the plus sign after selecting a searchable property to add it to the list. Then you can drag them to change their order.
You may choose to highlight a few of the listings on throughout your site with the Featured Listings block. You can choose to display these as a static list or an animated slideshow. Most of this is fairly straight forward, but to get listings to display within this block, they must first have the Featured Listing page property checked.
If you have some basic php and html skills, you can change the way that listings are displayed, or add additional listing attributes. For example, if you'd like to store and display a new attribute for each listing, first create the new page attribute within the dashboard (dashboard->pages & themes->attributes). Then go to the page types tab, click the edit button next to the Real Estate Listing page type, and make your new attribute one of the default attributes. This will ensure that it will be displayed when you're creating a new listing. Then to make this attribute display on your Real Estate Listing detail page, you'll need to edit the file /packages/tony_real_estate/page_types/real_estate_listing.php. You'll see lots of other examples there of attributes and how they're displayed. It's recommended that you first copy this view to /page_types/real_estate_listing.php, to prevent it from being overwritten if you do an update. Also be sure to check out the property features page attribute, since that's an easy way to display new property attributes like "pool", or "garage", without the need for any custom changes.
If you need to change the way your listings search results are displayed, or to display additional attributes, you will need to manually edit the html view for this block. You should copy the view file from /packages/tony_real_estate/blocks/tony_real_estate_search/view.php to /block/tony_real_estate_search/view.php, to prevent it from being overwritten. If you need to edit the featured listings block display, you'll want to edit the file /packages/tony_real_estate/blocks/tony_featured_listings/view.php.
If you have specific questions about this tutorial, or using the provided blocks, feel free to add a comment below. If you have run into a bug or have a feature request for the real estate package, please use the Real Estate package support forum.