{"id":15,"date":"2026-09-16T10:28:30","date_gmt":"2026-09-16T10:28:30","guid":{"rendered":"https:\/\/docs.latw.ai\/uncategorized\/custom-ui\/"},"modified":"2026-09-16T10:28:30","modified_gmt":"2026-09-16T10:28:30","slug":"custom-ui","status":"publish","type":"post","link":"https:\/\/docs.latw.ai\/pl\/esti-to-wordpress\/custom-ui\/","title":{"rendered":"Custom UI"},"content":{"rendered":"

Building a custom UI<\/h1>\n

When the bundled templates are the wrong starting point, ignore them. Offers are ordinary posts, so anything you can
\nbuild with WP_Query<\/code> you can build here \u2014 while still reusing the plugin’s filtering contract, its slug resolution and
\nits data helpers.<\/p>\n

The pieces you build on<\/h2>\n\n\n\n\n\n\n\n\n\n\n
Piece<\/th>\nWhat it gives you<\/th>\n<\/tr>\n<\/thead>\n
OSFEC_CPT::POST_TYPE<\/code><\/td>\n'osfec_offer'<\/code><\/td>\n<\/tr>\n
OSFEC_Query::request()<\/code><\/td>\nThe whitelisted, sanitized GET parameters<\/td>\n<\/tr>\n
OSFEC_Query::build_args( $request, $base )<\/code><\/td>\nThose parameters as WP_Query<\/code> arguments, merged into your own base<\/td>\n<\/tr>\n
OSFEC_Query::archive_url( $request )<\/code><\/td>\nThe archive URL carrying a set of filters<\/td>\n<\/tr>\n
osfec_field()<\/code>, osfec_photos()<\/code>, osfec_agent()<\/code>, \u2026<\/td>\nField access and formatting \u2014 see the PHP API<\/a><\/td>\n<\/tr>\n
osfec_type_options()<\/code>, osfec_slug_map()<\/code><\/td>\nReady-made option lists for your own form controls<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

A list of offers<\/h2>\n
$request = OSFEC_Query::request();\n\n$args = OSFEC_Query::build_args(\n    $request,\n    array(\n        'post_type'      => OSFEC_CPT::POST_TYPE,\n        'post_status'    => 'publish',\n        'posts_per_page' => 12,\n        'no_found_rows'  => true, \/\/ drop this if you need pagination\n    )\n);\n\n$offers = new WP_Query( $args );\n\nif ( $offers->have_posts() ) :\n    while ( $offers->have_posts() ) :\n        $offers->the_post();\n        \/\/ your markup\n    endwhile;\nendif;\n\nwp_reset_postdata();<\/code><\/pre>\n
build_args()<\/code> handles the parts that are easy to get wrong: the meta query for every filter, DECIMAL<\/code> casting on the
\nprice and area ranges, sorting by meta_value_num<\/code>, and resolving ?city=bialystok<\/code> back to the stored Bia\u0142ystok<\/code>.<\/p>\n
Passing an empty $request<\/code> gives you a plain, unfiltered list with the default ordering \u2014 useful for a “featured
\noffers” strip that must ignore whatever the visitor filtered elsewhere on the page.<\/p>\n
Hard-coding filters, but letting visitors override them<\/h2>\n
The shortcode’s own behaviour, in three lines: start from the request, and only fill in a default where the visitor
\nsupplied nothing.<\/p>\n
$request = OSFEC_Query::request();\n\nforeach ( array( 'type' => 'mieszkanie', 'city' => 'Bia\u0142ystok' ) as $key => $value ) {\n    if ( ! isset( $request[ $key ] ) ) {\n        $request[ $key ] = $value;\n    }\n}<\/code><\/pre>\n
To force<\/em> a filter regardless of the URL, set it after the merge \u2014 or bypass $request<\/code> entirely and add your own
\nmeta_query<\/code> clause to the $base<\/code> array; build_args()<\/code> merges into whatever meta_query<\/code> it finds there.<\/p>\n
Your own filter form<\/h2>\n
The filtering contract is the GET parameter names. Reproduce them and everything else keeps working \u2014 the archive, the
\nshortcode, caching, the back button, shareable links.<\/p>\n
$request = OSFEC_Query::request();\n$types   = osfec_type_options();          \/\/ slug => label\n$cities  = osfec_slug_map( 'city' );      \/\/ slug => raw value\n?>\n<form method=\"get\" action=\"<?php echo esc_url( OSFEC_Query::archive_url() ); ?>\">\n    <select name=\"type\">\n        <option value=\"\"><?php esc_html_e( 'Any', 'your-theme' ); ?><\/option>\n        <?php foreach ( $types as $slug => $label ) : ?>\n            <option value=\"<?php echo esc_attr( $slug ); ?>\"\n                <?php selected( isset( $request['type'] ) ? $request['type'] : '', $slug ); ?>>\n                <?php echo esc_html( $label ); ?>\n            <\/option>\n        <?php endforeach; ?>\n    <\/select>\n\n    <input type=\"number\" name=\"price_max\" min=\"0\"\n        value=\"<?php echo esc_attr( isset( $request['price_max'] ) ? $request['price_max'] : '' ); ?>\">\n\n    <button type=\"submit\"><?php esc_html_e( 'Search', 'your-theme' ); ?><\/button>\n<\/form><\/code><\/pre>\n
Rules:<\/p>\n