array( 'name' => __( 'Shortlinks', '360-orbit-shortlink-service' ), 'singular_name' => __( 'Shortlink', '360-orbit-shortlink-service' ), 'add_new' => __( 'Add New', '360-orbit-shortlink-service' ), 'add_new_item' => __( 'Add New Shortlink', '360-orbit-shortlink-service' ), 'edit_item' => __( 'Edit Shortlink', '360-orbit-shortlink-service' ), 'new_item' => __( 'New Shortlink', '360-orbit-shortlink-service' ), 'view_item' => __( 'View Shortlink', '360-orbit-shortlink-service' ), 'search_items' => __( 'Search Shortlinks', '360-orbit-shortlink-service' ), 'not_found' => __( 'No shortlinks found.', '360-orbit-shortlink-service' ), 'not_found_in_trash' => __( 'No shortlinks found in the trash.', '360-orbit-shortlink-service' ), 'all_items' => __( 'Shortlinks', '360-orbit-shortlink-service' ), 'menu_name' => __( 'Shortlinks', '360-orbit-shortlink-service' ), ), 'public' => false, 'publicly_queryable' => false, 'exclude_from_search' => true, 'show_ui' => true, 'show_in_menu' => Wp360_Shortlink_Service_Orbit_Menu::SLUG, 'show_in_nav_menus' => false, 'show_in_admin_bar' => false, 'show_in_rest' => false, 'has_archive' => false, 'rewrite' => false, 'query_var' => false, 'hierarchical' => false, 'supports' => array( 'title' ), 'capability_type' => array( 'wp360_sl_link', 'wp360_sl_links' ), 'map_meta_cap' => true, 'capabilities' => array( 'edit_posts' => $cap, 'edit_others_posts' => $cap, 'edit_private_posts' => $cap, 'edit_published_posts' => $cap, 'publish_posts' => $cap, 'read_private_posts' => $cap, 'delete_posts' => $cap, 'delete_private_posts' => $cap, 'delete_published_posts' => $cap, 'delete_others_posts' => $cap, ), 'delete_with_user' => false, // Der WordPress-Importer legt den Beitrag vor seinen Meta-Feldern an: der Slug wuerde neu vergeben, // gedruckte Links liefen ins Leere. Umziehen geht ueber den CSV-Export (Pro) oder eine Datenbank-Kopie. 'can_export' => false, ) ); } /** * Ziel-URL des Shortlinks (ungeprueft, so wie gespeichert). * * @param int $post_id Beitrags-ID. * @return string */ public static function get_target_url( $post_id ) { return (string) get_post_meta( (int) $post_id, self::META_URL, true ); } /** * Vergebener Slug des Shortlinks oder ein leerer Text, solange noch keiner vergeben ist. * * @param int $post_id Beitrags-ID. * @return string */ public static function get_slug( $post_id ) { return (string) get_post_meta( (int) $post_id, self::META_SLUG, true ); } /** * Ist der Slug belegt? Belegt heisst: einem vorhandenen Shortlink (auch im Papierkorb * oder im Archiv) zugeordnet oder von einem endgueltig geloeschten. * * @param string $slug Slug. * @return bool */ public static function slug_is_taken( $slug ) { global $wpdb; if ( in_array( $slug, self::retired_slugs(), true ) ) { return true; } // Die Meta-Kopie traegt den Slug unabhaengig von Papierkorb und Status. // Direkte Abfrage, weil WP_Query Papierkorb-Beitraege nicht findet; sie laeuft nur bei der Vergabe. // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching $found = $wpdb->get_var( $wpdb->prepare( "SELECT post_id FROM {$wpdb->postmeta} WHERE meta_key = %s AND meta_value = %s LIMIT 1", self::META_SLUG, $slug ) ); return null !== $found; } /** * Alle nie wieder zu vergebenden Slugs: die gespeicherten und die in dieser Anfrage gerade geloeschten. * * @return string[] */ public static function retired_slugs() { return array_values( array_unique( array_merge( self::stored_retired_slugs(), self::$pending_retired ) ) ); } /** * @return string[] */ private static function stored_retired_slugs() { $list = get_option( self::RETIRED_OPTION, array() ); return is_array( $list ) ? array_values( array_filter( $list, 'is_string' ) ) : array(); } /** * Merkt sich den Slug eines endgueltig geloeschten Shortlinks, damit er nie wieder vergeben wird. * Autoload aus: die Liste wird nur bei der Vergabe gelesen. * * @param int $post_id Beitrags-ID. */ public static function retire_slug_of_deleted_post( $post_id ) { if ( self::POST_TYPE !== get_post_type( $post_id ) ) { return; } $slug = self::get_slug( $post_id ); if ( '' === $slug ) { return; } if ( in_array( $slug, self::retired_slugs(), true ) ) { return; } // Gebuendelt am Ende der Anfrage schreiben: "Papierkorb leeren" mit n Links schriebe sonst n-mal die ganze Liste. if ( array() === self::$pending_retired ) { add_action( 'shutdown', array( __CLASS__, 'flush_retired_slugs' ) ); } self::$pending_retired[] = $slug; } /** * Schreibt die in dieser Anfrage geloeschten Slugs in die Merkliste. */ public static function flush_retired_slugs() { if ( array() === self::$pending_retired ) { return; } $list = array_values( array_unique( array_merge( self::stored_retired_slugs(), self::$pending_retired ) ) ); self::$pending_retired = array(); update_option( self::RETIRED_OPTION, $list, false ); } /** * Vergibt beim ersten Speichern den Slug und sperrt ihn danach. Auto-Drafts * (WordPress legt sie beim Oeffnen von "Neu hinzufuegen" an und raeumt sie nach * sieben Tagen weg) bekommen keinen Slug, sonst fuellte sich die Liste der * vergebenen Slugs mit Wegwerfwerten. * * Setzt ausserdem die Regeln, die fuer Shortlinks gelten: nie "privat", nie * mit Passwort, nie veroeffentlicht ohne gueltige Ziel-URL. * * @param array $data Zu speichernde Beitragsdaten. * @param array $postarr Roh uebergebene Daten. * @return array */ public static function filter_insert_post_data( $data, $postarr ) { if ( ! isset( $data['post_type'] ) || self::POST_TYPE !== $data['post_type'] ) { return $data; } $status = $data['post_status']; if ( in_array( $status, array( 'auto-draft', 'inherit' ), true ) ) { return $data; } $data['post_password'] = ''; $data['comment_status'] = 'closed'; $data['ping_status'] = 'closed'; if ( 'private' === $status ) { $status = 'publish'; $data['post_status'] = 'publish'; } // Papierkorb: WordPress schreibt post_name selbst auf "slug__trashed" um. if ( 'trash' === $status ) { return $data; } $post_id = isset( $postarr['ID'] ) ? (int) $postarr['ID'] : 0; $stored = $post_id ? self::get_slug( $post_id ) : ''; if ( '' === $stored ) { $stored = Wp360_Shortlink_Service_Slug_Generator::generate( array( __CLASS__, 'slug_is_taken' ) ); if ( null === $stored ) { // Praktisch ausgeschlossen (31^6 Moeglichkeiten); dann lieber nichts veroeffentlichen. $data['post_status'] = 'draft'; self::add_notice( 'error', __( 'No free slug could be assigned. Please try saving again.', '360-orbit-shortlink-service' ) ); return $data; } self::$pending_slug = $stored; } $data['post_name'] = $stored; if ( '' === trim( (string) $data['post_title'] ) ) { /* translators: %s: automatically assigned slug of the shortlink */ $data['post_title'] = sprintf( __( 'Shortlink %s', '360-orbit-shortlink-service' ), $stored ); } // Ohne gueltige Ziel-URL darf nichts veroeffentlicht sein. Ein schon // veroeffentlichter Link behaelt dabei seine bisherige gueltige URL und // bleibt online; die Maske meldet, dass die neue Eingabe verworfen wurde. if ( in_array( $data['post_status'], array( 'publish', 'future' ), true ) ) { $url = Wp360_Shortlink_Service_Url_Validator::clean( (string) self::posted_url() ); if ( '' === $url && $post_id ) { $url = Wp360_Shortlink_Service_Url_Validator::clean( self::get_target_url( $post_id ) ); } if ( '' === $url ) { $data['post_status'] = 'draft'; self::add_notice( 'error', __( 'The target URL is missing or invalid (only http:// and https:// addresses are allowed). The shortlink was saved as a draft.', '360-orbit-shortlink-service' ) ); } } return $data; } /** * Schreibt den beim Einfuegen vergebenen Slug, sobald die Beitrags-ID feststeht. * * @param int $post_id Beitrags-ID. */ public static function store_pending_slug( $post_id ) { if ( '' === self::$pending_slug ) { return; } // Nur einmal schreiben: update_post_meta wuerde einen vorhandenen Slug ueberschreiben. if ( '' === self::get_slug( $post_id ) ) { add_post_meta( $post_id, self::META_SLUG, self::$pending_slug, true ); } self::$pending_slug = ''; } /** * Wiederhergestellte Shortlinks behalten ihren Status (veroeffentlicht oder archiviert); * WordPress setzt sie sonst auf "Entwurf". * * @param string $new_status Von WordPress vorgesehener Status. * @param int $post_id Beitrags-ID. * @param string $previous_status Status vor dem Papierkorb. * @return string */ public static function untrash_status( $new_status, $post_id, $previous_status ) { if ( self::POST_TYPE !== get_post_type( $post_id ) ) { return $new_status; } /** * Status, die beim Wiederherstellen aus dem Papierkorb erhalten bleiben (Pro ergaenzt den Archiv-Status). * * @param string[] $statuses Erlaubte Status. */ $keep = (array) apply_filters( 'wp360_sl_untrash_keep_statuses', array( 'publish' ) ); return in_array( $previous_status, $keep, true ) ? $previous_status : 'draft'; } /** * Legt einen Shortlink ohne Formular an (Import, Tests). Es gelten dieselben Regeln wie * in der Maske: Slug-Vergabe, URL-Pruefung, Entwurf bei ungueltiger URL. * * @param string $title Name des Links. * @param string $url Ziel-URL. * @param string $status Beitragsstatus. * @return int|WP_Error Beitrags-ID. */ public static function create( $title, $url, $status = 'publish' ) { self::$override_url = (string) $url; try { $id = wp_insert_post( array( 'post_type' => self::POST_TYPE, 'post_title' => $title, 'post_status' => $status, ), true ); // Die Maske speichert die URL nur mit passender Berechtigung (save_post); ohne Benutzer (WP-CLI, Cron) deshalb direkt. if ( ! is_wp_error( $id ) && $id ) { $clean = Wp360_Shortlink_Service_Url_Validator::clean( self::$override_url ); if ( '' !== $clean && self::get_target_url( $id ) !== $clean ) { update_post_meta( $id, self::META_URL, $clean ); } } return $id; } finally { self::$override_url = null; } } /** * Stammt das abgeschickte Formular von der Maske (gueltiges Nonce)? Pro nutzt das fuer weitere Felder. * * @return bool */ public static function has_valid_form_nonce() { return null !== self::posted_url(); } /** * Ziel-URL aus dem abgeschickten Formular, wenn ein gueltiges Nonce vorliegt, sonst null. * Roh (nur entschlackt), die Pruefung macht Url_Validator. * * @return string|null */ public static function posted_url() { if ( null !== self::$override_url ) { return self::$override_url; } if ( ! isset( $_POST[ self::URL_NONCE_FIELD ], $_POST['wp360_sl_url'] ) ) { return null; } $nonce = sanitize_text_field( wp_unslash( $_POST[ self::URL_NONCE_FIELD ] ) ); if ( ! wp_verify_nonce( $nonce, self::URL_NONCE_ACTION ) ) { return null; } return trim( sanitize_text_field( wp_unslash( $_POST['wp360_sl_url'] ) ) ); } /** * Merkt eine Meldung fuer den naechsten Seitenaufruf des angemeldeten Benutzers. * * @param string $type 'error', 'warning', 'success' oder 'info'. * @param string $message Text. */ public static function add_notice( $type, $message ) { $key = 'wp360_sl_notices_' . get_current_user_id(); $items = get_transient( $key ); $items = is_array( $items ) ? $items : array(); $item = array( 'type' => $type, 'message' => $message, ); if ( ! in_array( $item, $items, true ) ) { $items[] = $item; } set_transient( $key, $items, 120 ); } /** * Holt und loescht die gemerkten Meldungen des angemeldeten Benutzers. * * @return array */ public static function take_notices() { $key = 'wp360_sl_notices_' . get_current_user_id(); $items = get_transient( $key ); if ( false !== $items ) { delete_transient( $key ); } return is_array( $items ) ? $items : array(); } }