Migrationsanleitung

Inhaltsverzeichnis

Hooks
- Referenz
Änderungen
Installation
Einstellungen

Diese Migrationsanleitung soll Ihnen beim Übergang von SearchWP 3.x (und früher) zu SearchWP 4 helfen.

Hinweis: Ihr Lizenzschlüssel ist für SearchWP 3.x und SearchWP 4 derselbe

Hinweis: SearchWP 4 ist ein Hauptrelease, das die Abwärtskompatibilität bricht

(außer für SWP_Query, das nicht geändert wurde)

Da dies ein Hauptversionsrelease ist, das die Abwärtskompatibilität gebrochen hat, wird dringend empfohlen, die Migration zuerst auf einem Staging-Server durchzuführen, um sicherzustellen, dass der Prozess reibungslos verläuft, bevor die Migration auf einem Produktionsserver durchgeführt wird.

Hinweis: SearchWP 3 Engines, Einstellungen, Stoppwörter und Synonyme werden bei der Aktivierung von SearchWP 4 migriert.

Der Migrationsprozess kann in die folgenden Schritte unterteilt werden, die Sie unternehmen müssen:

Diese Migrationsanleitung vollständig durchlesen.
Sicherstellen, dass alle installierten Erweiterungen auf ihre neuesten Versionen aktualisiert wurden.
Auditing all hooks in use both in your theme and any custom plugins.
- Updating all existing hooks to SearchWP 4 equivalents, reaching out to support if any problems arise.
  Hinweis: Bitte überprüfen Sie die Dokumentation für alle Hooks, da sich einige Parameter geändert haben!
SearchWP 4 von Ihrem Konto herunterladen.
SearchWP 3.x aus Ihrer WordPress-Installation deaktivieren und löschen* (siehe Hinweis unten!).
SearchWP 4 installieren und aktivieren.
Automatic migration of settings from SearchWP 3.x to SearchWP 4 upon activation.
Hinweis: Attribut-Relevanzgewichte haben jetzt drei Segmente, und der Gewichtungsschieberegler zeigt das nächstgelegene Gewichtsegment an. Dies kann für Sie anders aussehen, wenn Sie Gewichte angepasst haben, aber die tatsächlichen Gewichte aus v3 bleiben erhalten, bis sie geändert und die Engines neu gespeichert werden.
Den initialen SearchWP 4 Index erstellen.
Funktionalität testen.

* Wenn Sie das Kontrollkästchen zum Entfernen aller SearchWP-Daten bei der Deinstallation angekreuzt haben, werden Ihre Daten gelöscht. Deaktivieren Sie das Kontrollkästchen, falls erforderlich.

Wenn das Kontrollkästchen nicht angekreuzt ist und Sie nicht den Hook searchwp_nuke_on_delete verwenden, um die Funktion zu aktivieren, bleiben alle Ihre SearchWP-Daten erhalten und nutzbar, falls Sie SearchWP 3.x jederzeit neu installieren möchten.

Hooks

Eine der brechenden Änderungen von SearchWP 3.x zu SearchWP 4 ist, dass alle Hooks neu getaggt wurden. Einige Hooks wurden umbenannt, funktionieren aber ansonsten gleich. Andere Hooks wurden komplett entfernt.

Bitte überprüfen Sie alle Ihre Hooks, während Sie die Tags aktualisieren, indem Sie die Dokumentation für jeden einzelnen überprüfen. Einige mögen eine einfache Tag-Änderung sein, andere eine einfache Parameteränderung, aber einige überflüssige Hooks in v3 wurden zugunsten eines neuen, besser geeigneten Hooks entfernt. Bitte testen Sie jeden Ihrer Hooks einzeln. ?

Es gibt eine Hook-Referenztabelle unten.

Änderungen von SearchWP 3

Der Index und der Indexer von SearchWP wurden komplett überarbeitet, einschließlich des Hintergrundprozesses. Dennoch gibt es Funktionsparität zwischen beiden Versionen. Sie funktionieren insgesamt auf ähnliche Weise, aber es gibt einige (bedeutende) Änderungen, die Sie beachten sollten.

Medien-Eltern

Wenn in SearchWP die Übertragung/Zuordnung des Eltern-Gewichts aktiviert war, wurden Medien ohne Elternteil von den Ergebnissen ausgeschlossen. SearchWP 4 gibt diese Ergebnisse jetzt zurück, damit sie nicht verloren gehen.

Wenn Sie bevorzugen, dass Medien ohne Elternteil (wenn die Übertragung des Eltern-Gewichts aktiviert ist) aus dem Ergebnissatz entfernt werden, können Sie diesen Hook verwenden:

	<?php

	// Tell SearchWP to drop Media with no parent when Parent Attribution has been enabled.
	// This was the default behavior in SearchWP 3 but has changed in SearchWP 4.
	add_filter( 'searchwp\source\post\attachment\parent_attribution\strict', '__return_true' );

view raw searchwp-customizations.php hosted with ❤ by GitHub

Taxonomie-Begriffe

In SearchWP 3 wurde standardmäßig nur term_name indiziert. Basierend auf Kundenfeedback hat sich dieses Verhalten geändert und schließt das gesamte WP_Term-Objekt ein, das den slug, die description und andere Daten enthält, die an jeden WP_Term angehängt sind, den SearchWP indiziert.

Wenn Sie dieses Verhalten umkehren möchten, erledigt dieser Snippet genau das: https://gist.github.com/jchristopher/0ecc4c6ed172f64e7a97748026266e32

Installation

SearchWP 4 ist eine Hauptversion, die auch eine komplette Neufassung von SearchWP 3.x darstellt. Die damit verbundenen Änderungen erfordern, dass SearchWP 3.x sowohl deaktiviert als auch gelöscht wird, bevor SearchWP 4 installiert wird.

Es wird empfohlen, SearchWP 3.x nach der Deaktivierung über die Plugins-Seite Ihrer WordPress-Installation zu löschen.

Hinweis: Auf der Registerkarte „Erweitert“ des Einstellungsbildschirms von SearchWP 3.x gibt es eine Einstellung, die bei Aktivierung alle Daten von SearchWP dauerhaft entfernt. Es gibt auch einen Hook: searchwp_nuke_on_delete.

Wenn Sie nicht möchten, dass Ihre Daten bei der Deinstallation gelöscht werden, stellen Sie bitte sicher, dass sowohl das Kontrollkästchen deaktiviert als auch der Hook nicht vorhanden ist.

Sofern Sie nicht zugestimmt haben, dass Ihre SearchWP 3.x-Daten beim Löschen des Plugins dauerhaft entfernt werden, bleiben Ihr SearchWP 3.x-Index und Ihre Einstellungen während dieses Vorgangs unverändert und stehen Ihnen zur Verfügung, falls Sie sich jederzeit für eine Rückkehr zu SearchWP 3.x entscheiden.

Wenn Sie nach dem Upgrade die Daten von SearchWP 3.x dauerhaft entfernen möchten (während Sie Ihre SearchWP 4-Daten behalten), können Sie diese Erweiterung verwenden: Legacy Data Removal.

Einstellungen

Bei der Aktivierung erkennt, migriert und importiert SearchWP 4 alle Ihre vorhandenen Einstellungen, z. B. die Engine-Konfiguration.

Ihr vorhandener Index wird nicht direkt migriert, da sich das Format erheblich geändert hat. Nach der Aktivierung beginnt SearchWP 4 mit dem Wiederaufbau Ihres Index unter Verwendung Ihrer migrierten Engines. Sobald der Index erstellt ist, ist Ihre Migration abgeschlossen!

Sie sollten einige Suchen testen, um die Funktionalität sicherzustellen. Wenn Sie auf Probleme stoßen, eröffnen Sie bitte so bald wie möglich ein Support-Ticket.

Bitte beachten Sie, dass Ihre SearchWP 3.x-Daten immer noch verfügbar sind, indem Sie SearchWP 4 vollständig entfernen und SearchWP 3.x neu installieren, es sei denn, Sie haben sich dafür entschieden, Ihre SearchWP 3.x-Daten beim Löschen des Plugins dauerhaft zu entfernen. Ein Download-Link ist immer in Ihrem Konto verfügbar.

Referenz zur Hook-Migration

SearchWP 3.x	SearchWP 4
Aktionen
`searchwp_after_query_index`	`searchwp\query\after`
`searchwp_before_query_index`	`searchwp\query\before`
`searchwp_index_initial_complete`	`searchwp\indexer\complete`
`searchwp_index_pdf_metadata`	`searchwp\document\pdf_metadata\skip`
`searchwp_index_post`	`searchwp\index\add`
`searchwp_index_up_to_date`	N/A
`searchwp_indexer_loopback`	N/A
`searchwp_indexer_post_chunk`	`searchwp\indexer\batch`
`searchwp_indexer_posts`	`searchwp\indexer\has_updates`
`searchwp_indexer_pre`	`searchwp\indexer\init`
`searchwp_indexer_pre_chunk`	`searchwp\indexer\batch`
`searchwp_indexer_pre_get_comments`	N/A
`searchwp_indexer_running`	`searchwp\process\begin`
`searchwp_load`	`searchwp\init`
`searchwp_loaded`	`searchwp\loaded`
`searchwp_log`	`searchwp\debug\log`
`searchwp_revised_search_query`	`searchwp\query\ran`
`searchwp_settings_after_header`	`searchwp\settings\header\after`
`searchwp_settings_after\{$view}`	`searchwp\settings\after\{$view}`
`searchwp_settings_before_header`	`searchwp\settings\header\before`
`searchwp_settings_before\{$view}`	`searchwp\settings\before\{$view}`
`searchwp_settings_engines`	`searchwp\settings\view\default`
`searchwp_settings_footer`	`searchwp\settings\footer`
`searchwp_settings_init`	`searchwp\settings\init`
`searchwp_settings_nav_tab`	`searchwp\settings\nav\tab`
`searchwp_settings_view\{$view}`	`searchwp\settings\view\{$view}`
`searchwp_dashboard_widget`	`searchwp\admin\dashboard_widgets\statistics`
`searchwp_swp_query_shutdown`	`searchwp\swp_query\shutdown`

Allgemeine Filter
`searchwp_admin_bar`	`searchwp\admin_bar`
`searchwp_dashboard_widget_cap`	`searchwp\statistics\capability`
`searchwp_debug`	`searchwp\debug`
`searchwp_debug_detailed`	N/A
`searchwp_debug_include_pid`	N/A
`searchwp_extensions`	`searchwp\extensions`
`searchwp_failed_index_notice`	N/A
`searchwp_init`	`searchwp\loaded`
`searchwp_initial_engine_settings`	`searchwp\install\engine\settings`
`searchwp_license_key`	`searchwp\license\key`
`searchwp_locale_override`	`locale`
`searchwp_missing_integration_notices`	`searchwp\missing_integration_notices`
`searchwp_nuke_on_delete`	`searchwp\nuke_on_delete`
`searchwp_settings_cap`	`searchwp\settings\capability`
`searchwp_show_conflict_notices`	N/A
`searchwp_show_filter_conflict_notices`	N/A
`searchwp_skip_vendor_libs`	N/A
`searchwp_statistics_cap`	`searchwp\statistics\capability`
`searchwp_statistics_popular_days_{$days}`	`searchwp\statistics\popular\days_{$days}`

Indexer
`searchwp_aggressive_delta_update`	`searchwp\index\aggressive_delta`
`searchwp_alternate_indexer`	`searchwp\indexer\alternate`
`searchwp_auto_reindex`	`searchwp\index\process\enabled` und `searchwp\indexer\paused`
`searchwp_background_deltas`	`searchwp\index\process\enabled`
`searchwp_basic_auth_creds`	`searchwp\indexer\http_basic_auth_credentials`
`searchwp_custom_field_{$key}`	`searchwp\source\post\attributes\meta\{$key}`
`searchwp_custom_fields`	`searchwp\source\post\attributes\meta`
`searchwp_custom_stemmer`	`searchwp\stemmer\custom`
`searchwp_do_blocks`	`searchwp\source\post\attributes\content\do_blocks`
`searchwp_do_shortcode`	`searchwp\source\post\attributes\content\do_shortcodes`
`searchwp_endpoint`	N/A
`searchwp_exclude_common`	N/A
`searchwp_excluded_custom_fields`	`searchwp\source\post\attributes\meta\ignored`
`searchwp_exclusive_regex_matches`	`searchwp\tokens\tokenize_pattern_matches`
`searchwp_external_pdf_processing`	`searchwp\parser\pdf`
`searchwp_extra_metadata`	N/A siehe KB-Artikel
`searchwp_get_custom_fields`	N/A
`searchwp_include_comment_author`	`searchwp\source\post\attributes\comments\author`
`searchwp_include_comment_email`	`searchwp\source\post\attributes\comments\email`
`searchwp_index_attachments`	N/A
`searchwp_index_chunk_size`	`searchwp\indexer\batch_size`
`searchwp_index_comments`	N/A
`searchwp_index_emoji`	`searchwp\allow_emoji`
`searchwp_indexed_post_types`	Teilweise Entsprechung: `searchwp\sources`
`searchwp_indexer_additional_meta_exclusions`	N/A
`searchwp_indexer_apply_engines_rules`	N/A
`searchwp_indexer_comment`	`searchwp\source\post\attributes\comment`
`searchwp_indexer_comments_args`	`searchwp\source\post\attributes\comments\args`
`searchwp_indexer_enabled`	N/A
`searchwp_indexer_excluded_by_rules`	N/A
`searchwp_indexer_load_monitoring`	N/A
`searchwp_indexer_loopback_args`	`searchwp\indexer\loopback\args`
`searchwp_indexer_max_attempts`	N/A
`searchwp_indexer_paused`	N/A
`searchwp_indexer_pre_process_content`	`searchwp\source\post\attributes\content`
`searchwp_indexer_tag_attributes`	`searchwp\valid_html_tags`
`searchwp_indexer_taxonomies`	N/A
`searchwp_indexer_taxonomy_term`	`searchwp\source\post\attributes\taxonomy\term`
`searchwp_indexer_taxonomy_term_index_slug`	N/A
`searchwp_indexer_taxonomy_terms`	`searchwp\source\post\attributes\taxonomy\terms`
`searchwp_indexer_throttle`	N/A
`searchwp_indexer_unindexed_args`	`searchwp\post__in` `searchwp\post__not_in`
`searchwp_indexer_unindexed_media_args`	`searchwp\post__in` `searchwp\post__not_in`
`searchwp_is_attribute_used`	N/A
`searchwp_is_used_meta_key`	N/A
`searchwp_is_used_taxonomy`	N/A
`searchwp_keyword_stem_locale`	N/A
`searchwp_lenient_accents`	`searchwp\tokens\strict`
`searchwp_lenient_accent_result`	`searchwp\tokens\removed_accents`
`searchwp_lenient_accents_conversions`	N/A
`searchwp_load_maximum`	N/A
`searchwp_max_delta_attempts`	N/A
`searchwp_max_index_attempts`	N/A
`searchwp_mimes_{$mime_type_group}`	N/A
`searchwp_minimum_word_length`	`searchwp\tokens\minimum_length`
`searchwp_omit_document_processing`	N/A
`searchwp_omit_meta_key`	N/A
`searchwp_omit_meta_key_{$custom_field_key}`	N/A
`searchwp_omit_wp_metadata`	N/A
`searchwp_pdf_metadata`	N/A
`searchwp_pdf_spaces_to_content_percentage`	N/A
`searchwp_post_statuses`	`searchwp\post_stati`
`searchwp_pre_set_post`	N/A
`searchwp_prevent_indexing`	`searchwp\post__not_in`
`searchwp_process_term_limit`	`searchwp\index\tokens_max`
`searchwp_remove_pre_get_posts`	N/A
`searchwp_sanitize_terms`	N/A
`searchwp_set_post`	N/A
`searchwp_stopwords`	`searchwp\stopwords`
`searchwp_term_count_limit`	`searchwp\index\tokens_max`
`searchwp_term_pattern_whitelist`	`searchwp\tokens\regex_patterns`
`searchwp_timeout`	`searchwp\indexer\loopback\args`

Abfragefilter
`searchwp_allow_quoted_phrase_search`	`searchwp\query\logic\phrase`
`searchwp_and_fields`	N/A
`searchwp_and_fields_{$post_type}`	N/A
`searchwp_and_logic`	`searchwp\query\logic\and`
`searchwp_and_logic_only`	`searchwp\query\logic\and\strict`
`searchwp_auto_output_revised_search_query`	`searchwp\query\output_suggested_search`
`searchwp_big_selects`	N/A
`searchwp_custom_field_keys`	`searchwp\source\attribute\options`
`searchwp_debug_append_weights_to_titles`	N/A
`searchwp_disable_impose_engine_config`	N/A
`searchwp_do_suggestions`	`searchwp\query\partial_matches\did_you_mean`
`searchwp_enable_attribution_{post_type}`	`searchwp\source\post\{$post_type}\attribution`
`searchwp_enable_parent_attribution_{post_type}`	`searchwp\source\post\{$post_type}\parent_attribution`
`searchwp_engine_settings_{engine}`	N/A
`searchwp_exclude`	`searchwp\post__not_in`
`searchwp_exclude_common`	N/A
`searchwp_force_run`	N/A
`searchwp_force_wp_query`	N/A
`searchwp_force_wpquery_order`	N/A
`searchwp_found_post_objects`	N/A
`searchwp_fuzzy_digit_threshold`	N/A
`searchwp_fuzzy_min_length`	`searchwp\query\partial_matches\fuzzy\minimum_length`
`searchwp_fuzzy_threshold`	`searchwp\query\partial_matches\fuzzy\threshold`
`searchwp_in_admin`	N/A
`searchwp_include`	`searchwp\post__in`
`searchwp_like_min_length`	`searchwp\query\partial_matches\minimum_length`
`searchwp_like_stem`	N/A
`searchwp_like_wildcard_after`	`searchwp\query\partial_matches\wildcard_after`
`searchwp_like_wildcard_before`	`searchwp\query\partial_matches\wildcard_before`
`searchwp_load_posts`	N/A
`searchwp_log_search`	`searchwp\statistics\log`
`searchwp_max_and_results`	N/A
`searchwp_max_search_terms`	`searchwp\query\tokens\limit`
`searchwp_max_search_terms_{$engine}`	N/A
`searchwp_max_search_terms_supplemental`	N/A
`searchwp_partial_matches_force_fuzzy`	`searchwp\query\partial_matches\force_fuzzy`
`searchwp_partial_matches_lenient`	`searchwp\query\partial_matches\force`
`searchwp_partial_matching_{$engine}`	N/A
`searchwp_persist_extra_metadata`	N/A
`searchwp_posts_per_page`	`searchwp\query\per_page`
`searchwp_pre_search_terms`	`searchwp\query\tokens`
`searchwp_query_allow_query_string_override_order`	`searchwp\query\mods`
`searchwp_query_allow_query_string_override_orderby`	`searchwp\query\mods`
`searchwp_query_conditions`	`searchwp\query\mods`
`searchwp_query_join`	`searchwp\query\mods`
`searchwp_query_limit_start`	`searchwp\query\mods`
`searchwp_query_limit_total`	`searchwp\query\mods`
`searchwp_query_main_join`	`searchwp\query\mods`
`searchwp_query_offset`	`searchwp\query\mods`
`searchwp_query_orderby`	`searchwp\query\mods`
`searchwp_query_results`	`searchwp\query\results`
`searchwp_query_select_inject`	`searchwp\query\mods`
`searchwp_refine_and_results`	N/A
`searchwp_remove_pre_get_posts_during_search`	N/A
`searchwp_results`	`searchwp\query\results`
`searchwp_return_orderby_date`	`searchwp\query\mods`
`searchwp_return_orderby_random`	`searchwp\query\mods`
`searchwp_search_args`	`searchwp\query\args`
`searchwp_search_query_order`	`searchwp\query\mods`
`searchwp_short_circuit`	`searchwp\native\short_circuit`
`searchwp_swp_query_post__in_explicit`	N/A
`searchwp_swp_query_post__not_in_explicit`	N/A
`searchwp_term_in`	`searchwp\query\tokens`
`searchwp_terms`	`searchwp\query\search_string`
`searchwp_weight_max`	N/A
`searchwp_weight_mods`	`searchwp\query\mods`
`searchwp_weight_threshold`	`searchwp\query\min_relevance`
`searchwp_where`	`searchwp\query\mods`

Dokumentenverarbeitung
`searchwp_file_content_limit`	`searchwp\source\attachment\attribute\document_content\display_limit`
`searchwp_purge_document_content`	Snippet anzeigen

Hervorhebung
`searchwp_term_highlight_break_on_first_match`	N/A
`searchwp_term_highlight_occurrence`	N/A
`searchwp_th_auto_filter_excerpt`	N/A
`searchwp_th_auto_highlight_content`	N/A
`searchwp_th_do_shortcode`	N/A
`searchwp_th_excluded_engines`	N/A
`searchwp_th_num_words`	N/A
`searchwp_th_partial_matches`	N/A
`searchwp_th_password_required_message`	N/A
`searchwp_th_pre_process_content`	N/A
`searchwp_th_pre_process_meta_value`	N/A
`searchwp_th_strip_shortcodes`	N/A
`searchwp_th_use_span`	N/A

Einstellungen UI
`searchwp_engine_content_type_label`	`searchwp\source\attribute\label`