{"id":685,"date":"2025-03-24T14:27:23","date_gmt":"2025-03-24T14:27:23","guid":{"rendered":"https:\/\/wpgeodirectory.com\/documentation\/article\/create-a-listing-frontend-users\/"},"modified":"2025-04-03T15:23:44","modified_gmt":"2025-04-03T14:23:44","slug":"create-a-listing-frontend-users","status":"publish","type":"gd_place","link":"https:\/\/wpgeodirectory.com\/documentation\/article\/first-steps\/create-a-listing-frontend-users\/","title":{"rendered":"Create a Listing &#8211; Frontend (users)"},"content":{"rendered":"<section class=\"alert alert-info\">\n\t To allow users to add listings please make sure WordPress user registration is enabled under: <strong><br \/>\n\t Settings &gt; General &gt; Anyone can register<br \/>\n\t<\/strong><\/section>\n<p>\n\tUsers of the site will use the frontend page to add listings. The frontend page saves all information via AJAX after every change.&nbsp; This ensures no data is lost and if for some reason a user abandons the add listing process, their information will be right there when they return.<\/p>\n<ol>\n<li><strong>Visit the front end add listing page.<\/strong> By default, this page is mysite.com\/add-listing\/ if you do not already have it in your main menu you can add it under the normal WordPress menu settings Appearance &gt;Menus.<\/li>\n<li><strong>Complete the required fields.<\/strong>&nbsp; If you installed dummy data it will have added fields specific to the data type selected.&nbsp; Custom fields can be added or edited under&nbsp;<strong>Places &gt; Settings &gt; Custom Fields<\/strong>.<br \/>\n<section class=\"alert alert-info\">Below we will go over the required fields only as custom fields can be specific to your data type.<\/section>\n<\/li>\n<li><strong>Title<\/strong>&nbsp;&#8211; Enter a title for the listing, it is used throughout the site.\n<p>\n\t\t<img width=\"446\" height=\"93\" src=\"https:\/\/wpgeodirectory.com\/documentation\/wp-content\/uploads\/2025\/03\/file-jk3EYERBMO.png\" class=\"attachment-large size-large\" alt=\"\" decoding=\"async\" loading=\"lazy\" srcset=\"https:\/\/wpgeodirectory.com\/documentation\/wp-content\/uploads\/2025\/03\/file-jk3EYERBMO.png 446w, https:\/\/wpgeodirectory.com\/documentation\/wp-content\/uploads\/2025\/03\/file-jk3EYERBMO-300x63.png 300w\" sizes=\"auto, (max-width: 446px) 100vw, 446px\" \/>\n\t<\/p>\n<\/li>\n<li><strong>Description<\/strong>&nbsp;&#8211; Enter a description for the listing.<\/li>\n<li><strong>Category<\/strong>&nbsp;&#8211; Select a category for your listing. Multiple categories can be set, if multiple are selected then a default can also be selected (<em>Hotels is set as the default below<\/em>). The default category can be used for the URL slug and determines the map icon used.\n<p>\n\t\t<img width=\"553\" height=\"88\" src=\"https:\/\/wpgeodirectory.com\/documentation\/wp-content\/uploads\/2025\/03\/file-rnSCoixCFl.png\" class=\"attachment-large size-large\" alt=\"\" decoding=\"async\" loading=\"lazy\" srcset=\"https:\/\/wpgeodirectory.com\/documentation\/wp-content\/uploads\/2025\/03\/file-rnSCoixCFl.png 553w, https:\/\/wpgeodirectory.com\/documentation\/wp-content\/uploads\/2025\/03\/file-rnSCoixCFl-300x48.png 300w\" sizes=\"auto, (max-width: 553px) 100vw, 553px\" \/>\n\t<\/p>\n<\/li>\n<li><strong>Address<\/strong>&nbsp;&#8211; There are several convenient ways to set the address for a listing.<br \/> <strong>Doing one of the following will auto-set the correct info for all the address fields.<\/strong>\n<ul>\n<li>Drag the map to the desired position.&nbsp;<\/li>\n<li>Drag the map marker to the desired position.<\/li>\n<li>Enter the address and then click&nbsp;<em>Set Address on map<\/em>. This will try to set the correct map position.<\/li>\n<li>Clicking the&nbsp;<em>My Location<\/em>&nbsp;icon in the street address field will work if you are currently at the location you wish to add.&nbsp;<\/li>\n<p>\t\t<img width=\"629\" height=\"502\" src=\"https:\/\/wpgeodirectory.com\/documentation\/wp-content\/uploads\/2025\/03\/file-5rTJT3aEUV.png\" class=\"attachment-large size-large\" alt=\"\" decoding=\"async\" loading=\"lazy\" srcset=\"https:\/\/wpgeodirectory.com\/documentation\/wp-content\/uploads\/2025\/03\/file-5rTJT3aEUV.png 629w, https:\/\/wpgeodirectory.com\/documentation\/wp-content\/uploads\/2025\/03\/file-5rTJT3aEUV-300x239.png 300w\" sizes=\"auto, (max-width: 629px) 100vw, 629px\" \/>\n\t<\/ul>\n<section class=\"alert alert-info\">The <a href=\"https:\/\/wpgeodirectory.com\/downloads\/location-manager\/\">Location Manager extension<\/a> is required to add listings outside of the default location<\/section>\n<\/li>\n<li> <strong>Images<\/strong>&nbsp;&#8211; Although not a required field,&nbsp;there are some points to mention.\n<ul>\n<li>The first image added will be used as the featured image.<\/li>\n<li>Image title and caption can be set for better SEO &amp; accessibility performance.<\/li>\n<li>Images can be dragged and dropped to set the order required.<\/li>\n<li>If no image is set then many different types of fallback images can be set, these include; Site default image, CPT default image, Category default image or even a screenshot of a website URL can be auto-generated to show. (<em>image output defaults are set in the page templates<\/em>)\n\t\t<\/li>\n<\/ul>\n<p>\n\t\t<img width=\"617\" height=\"549\" src=\"https:\/\/wpgeodirectory.com\/documentation\/wp-content\/uploads\/2025\/03\/file-29xNKpctAs.png\" class=\"attachment-large size-large\" alt=\"\" decoding=\"async\" loading=\"lazy\" srcset=\"https:\/\/wpgeodirectory.com\/documentation\/wp-content\/uploads\/2025\/03\/file-29xNKpctAs.png 617w, https:\/\/wpgeodirectory.com\/documentation\/wp-content\/uploads\/2025\/03\/file-29xNKpctAs-300x267.png 300w\" sizes=\"auto, (max-width: 617px) 100vw, 617px\" \/><img width=\"671\" height=\"181\" src=\"https:\/\/wpgeodirectory.com\/documentation\/wp-content\/uploads\/2025\/03\/file-6TjUPNWoVW.png\" class=\"attachment-large size-large\" alt=\"\" decoding=\"async\" loading=\"lazy\" srcset=\"https:\/\/wpgeodirectory.com\/documentation\/wp-content\/uploads\/2025\/03\/file-6TjUPNWoVW.png 671w, https:\/\/wpgeodirectory.com\/documentation\/wp-content\/uploads\/2025\/03\/file-6TjUPNWoVW-300x81.png 300w\" sizes=\"auto, (max-width: 671px) 100vw, 671px\" \/>\n\t<\/p>\n<\/li>\n<li><strong>Click Submit Listing<\/strong> &#8211; By default this will:\n<ul>\n<li>Place the listing in &#8220;<em>Pending Review<\/em>&#8221; status.<\/li>\n<li>Email the admin that a listing needs to be reviewed.<\/li>\n<li>Email the user their listing has been submitted for approval.<\/li>\n<li>A separate user email is sent when the email is approved.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"<p>To allow users to add listings please make sure WordPress user registration is enabled under: Settings &gt; General &gt; Anyone can register Users of the site will use the frontend page to add listings. The frontend page saves all information via AJAX after every change.&nbsp; This ensures no data is lost and if for some [&hellip;]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"article\/tags":[454,455,456,457],"article\/categories":[208,395],"class_list":["post-685","gd_place","type-gd_place","status-publish","hentry","gd_place_tags-add","gd_place_tags-listing","gd_place_tags-adding","gd_place_tags-place","gd_placecategory-getting-started","gd_placecategory-first-steps"],"_links":{"self":[{"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/article\/685","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/article"}],"about":[{"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/types\/gd_place"}],"replies":[{"embeddable":true,"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/comments?post=685"}],"version-history":[{"count":0,"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/article\/685\/revisions"}],"wp:attachment":[{"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/media?parent=685"}],"wp:term":[{"taxonomy":"gd_place_tags","embeddable":true,"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/article\/tags?post=685"},{"taxonomy":"gd_placecategory","embeddable":true,"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/article\/categories?post=685"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}