6. The WP OTIS Dashboard - thinkshout/wp-otis GitHub Wiki

As of version 1.0, the WP-OTIS plugin incorporates a new page into the Wordpress administrative dashboard. While the commands enabled on this page are available through the plugin's command line tools, the dashboard page provides a simpler interface and provides visibility into import status and events to any site editors with access to the tools menu. The page can be accessed at /wp/wp-admin/admin.php?page=otis-dashboard.

The OTIS Dashboard link is available below Site Options in the WP Admin sidebar menu.

The design of the page should be intuitive; please feel free to file an issue on this repository if it's not! The top tab provides a timestamp for when the import process last ran (either the regular, automatic background process or the manual bulk process), along with indicators of whether the listing or history imports are working in the background right now. Below that tab is "Import", which contains the controls to start a manual bulk import from a specific date range, or to stop a bulk import in process. Finally, under you can see some statistics about the number of synced listings on your site, and a few of the most recent log entries from the importer, with a link to the full log page.

If you've noticed that some recent imports on your site failed or timed out, or if you need to backfill listings after changing which categories you import, the bulk importer is the tool for you. Given a date range, it will query the OTIS API for the most recent versions of all listings which changed in that window, then check to see which status updates (eg, events expiring or listings being deleted) happened in that window as well.

If possible, when performing a bulk import, make your date range go through the current date. Status changes are processed in chronological order within the given date window, so this will ensure that old status updates don't override newer changes. That said, the import process can take hours, and sometimes long imports can end up timing out with a hiccup in the API connection, which means that the import will need to be restarted! If you're having trouble importing the last several months of data--from May through November, for instance--then you can use the date ranges to import all of May, then all of June, then all of July, and so on. If you choose to break the import into smaller chunks in this way, it's important to start with the oldest data and continue working forward until you reach the present.

To track the progress of an import job, you can use the OTIS Import Log page at /wp-admin/edit.php?post_type=poi&page=tror_poi_otis_log. An import job will always run in the background and should not impede the normal function of your WordPress site. It does this by using Action Scheduler, a powerful asynchronous job system designed specifically for WordPress by the makers of WooCommerce. If you want to examine the progress of those jobs out of the context of OTIS import data, you can use the Scheduled Actions page at /wp-admin/tools.php?page=action-scheduler.