{"id":370128,"date":"2026-09-22T14:33:16","date_gmt":"2026-09-22T14:33:16","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/ap-family-research\/"},"modified":"2026-09-22T18:44:19","modified_gmt":"2026-09-22T18:44:19","slug":"ap-family-research","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/ap-family-research\/","author":23496473,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.1","stable_tag":"1.0.1","tested":"7.1.2","requires":"6.2","requires_php":"8.0","requires_plugins":null,"header_name":"AP Family Research","header_author":"AncestorPress","header_description":"The private research workbench for family historians: capture certificates, photos and notes as artefacts, organise them around research questions, keep a research log (negative searches included), and promote hardened conclusions into your tree with citations attached.","assets_banners_color":"dbd7d0","last_updated":"2026-09-22 18:44:19","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/ancestorpress.com\/ap-family-research-wordpress-plugin\/","header_author_uri":"https:\/\/ancestorpress.com\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":61,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.1":{"tag":"1.0.1","author":"ancestorpress","date":"2026-09-22 18:44:19","revision":3707959}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3707849,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3707849,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3707849,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3707849,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.1"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[282082,277533,31766,24730,282081],"plugin_category":[],"plugin_contributors":[264221],"plugin_business_model":[],"class_list":["post-370128","plugin","type-plugin","status-publish","hentry","plugin_tags-brick-wall","plugin_tags-evidence","plugin_tags-family-history","plugin_tags-genealogy","plugin_tags-research-log","plugin_contributors-ancestorpress","plugin_committers-ancestorpress"],"banners":{"banner":"https:\/\/ps.w.org\/ap-family-research\/assets\/banner-772x250.png?rev=3707849","banner_2x":"https:\/\/ps.w.org\/ap-family-research\/assets\/banner-1544x500.png?rev=3707849","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/ap-family-research\/assets\/icon-128x128.png?rev=3707849","icon_2x":"https:\/\/ps.w.org\/ap-family-research\/assets\/icon-256x256.png?rev=3707849","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>AP Family Research is a private workbench for the part of family history that comes before the conclusion: unfiled certificates and photos, years of spreadsheets, notebook pages, conjectures, brick walls and the searches that found nothing. Capture it quickly, organise it around the questions you are trying to answer, keep an honest research log, and promote a proven conclusion into your family tree with its evidence attached.<\/p>\n\n<p><strong>Private by definition.<\/strong> There are no public pages, shortcodes, blocks or other front-end output, and every screen is for administrators. Your research stays in your own database and media library; nothing reaches your tree unless you promote it.<\/p>\n\n<h4>Free features<\/h4>\n\n<p>No cap on what you record and no time limit.<\/p>\n\n<ul>\n<li><strong>Capture<\/strong> - phone camera, single or bulk upload, and an inbox to file or discard items later. Nothing is required at capture, and related files (such as the front and back of a photo) can be kept as one item.<\/li>\n<li><strong>Spreadsheet import<\/strong> - map CSV columns to artefact fields; every row becomes an artefact.<\/li>\n<li><strong>Artefact store<\/strong> - types, tags, search and links to people in your tree. Transcriptions are stored exactly as typed, separate from your comments, with optional Mills evidence fields.<\/li>\n<li><strong>Research questions<\/strong> - questions, conjectures and brick walls, with your reasoning, a plan, and evidence for, against or neutral.<\/li>\n<li><strong>Research log<\/strong> - when and where you searched, what you sought and what came of it. Negative results are first-class entries, and repeating a search warns you.<\/li>\n<li><strong>Tasks by repository<\/strong> - to-do lists grouped by place, including plan steps.<\/li>\n<li><strong>Promotion<\/strong> - turn a proven conclusion into a fact on a person in your tree, with the chosen artefacts attached as media and cited as sources.<\/li>\n<li><strong>Full export<\/strong> - one .tar archive with every table as CSV, every original file with a readable description, a dossier per question and a note for whoever inherits your research.<\/li>\n<\/ul>\n\n<h4>Pro edition<\/h4>\n\n<p>A separate edition sold at ancestorpress.com and installed in place of this plugin; its code is not in this package. It adds AI transcription, extraction with link suggestions, question analysis and classification; duplicate detection with merges you approve; natural-language search; a brick-wall board, a research timeline and a printable dossier. The AI features use your own WordPress AI connector (WordPress 7.0 or later) at your own cost, and ask for consent before sending anything linked to a living person.<\/p>\n\n<h4>More from AncestorPress<\/h4>\n\n<p>AP Family Research is one of a small family of AncestorPress tools for family history research. Each works on its own, all are free on WordPress.org, and they share one data core - so a conclusion you promote here appears in the others with no re-import:<\/p>\n\n<ul>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/ap-family-trees\/\">AP Family Trees<\/a> - beautiful, interactive family tree charts and member profiles on any page. This is where a promoted conclusion shows up, with its citation attached.<\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/ap-family-archive\/\">AP Family Archive<\/a> - publish your family history as a complete website: a person page for every ancestor, family group pages, a surname index and full search, with living people protected automatically.<\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/ap-one-name-studies\/\">AP One-Name Studies<\/a> - give a one-name study a home on your own site: surname variants and deviants, a searchable occurrence index, and historic-county distribution maps.<\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/ap-one-place-studies\/\">AP One-Place Studies<\/a> - give a one-place study a home on your own site: the records of a parish, village, street or house as a searchable occurrence index, place and household pages, and full export.<\/li>\n<\/ul>\n\n<p>Linking people and promoting conclusions need a family tree in that shared data, for example one imported with AP Family Trees. Everything else here works on its own.<\/p>\n\n<h4>Third-party libraries<\/h4>\n\n<ul>\n<li><a href=\"https:\/\/github.com\/mrkrstphr\/php-gedcom\">php-gedcom<\/a> by Kristopher Wilson - MIT, bundled with the shared AncestorPress core.<\/li>\n<li><a href=\"https:\/\/github.com\/Freemius\/wordpress-sdk\">Freemius WordPress SDK<\/a> - GPLv3; release 2.13.4 with a small local PHP 8 fix.<\/li>\n<\/ul>\n\n<h3>External services<\/h3>\n\n<h4>Freemius<\/h4>\n\n<p>Purpose: optional account connection, licence administration, checkout and usage diagnostics, provided by Freemius, Inc. This plugin never downloads or installs the Pro edition; its updates come from WordPress.org.<\/p>\n\n<p>When: only if you opt in, connect or manage an account or licence, use checkout, or consent to diagnostics. If you skip the opt-in, every workbench feature still works.<\/p>\n\n<p>Data: the site URL, the administrator email you provide, plugin and WordPress versions and licence identifiers; usage diagnostics only with consent. No research is ever sent.<\/p>\n\n<p>Terms: https:\/\/freemius.com\/terms\/\nPrivacy: https:\/\/freemius.com\/privacy\/<\/p>\n\n<h4>AncestorPress Support Service<\/h4>\n\n<p>Purpose: answers questions about using the plugin through the optional Help assistant, the AncestorPress Support Copilot, provided by Black and White Trading Ltd through the <a href=\"https:\/\/bwtlsupport.com\/\">AncestorPress Support Service<\/a>. The assistant is read-only.<\/p>\n\n<p>When: nothing is sent until the site is connected (through the Freemius opt-in or a support token on the Support tab) and an administrator opens the assistant and accepts its privacy notice. The acceptance is recorded with who gave it and when, and can be withdrawn on the Support tab.<\/p>\n\n<p>Data with each question: the question and up to 20 recent chat messages; the site address and any Freemius installation ID or support token, to authorise the request; this plugin's version, the core library version, the versions of other active plugins whose folders begin \"ap-\" or \"ancp-\", the admin screen, the database schema revision, whether AI features are present and configured, and counts of artefacts, questions, log entries and tasks - never their contents. The free plan answers a limited number of questions a month. With Pro and your own AI provider, questions go to that provider instead and the service is asked only for documentation, unless the local answer fails.<\/p>\n\n<p>Tickets: with a licence or support token, only when you open the ticket form and click \"Create ticket\" does the plugin also send the conversation, the details above, the question category, the contact email you enter (pre-filled with your WordPress account email) and the first and last name from your WordPress profile; these are kept as a support ticket. On the free plan no ticket form is offered, so none of this is sent, and help from a person is on the WordPress.org support forum.<\/p>\n\n<p>Retention: questions are not stored, and the conversation stays in your browser until you leave the page. Authorisation checks are cached for up to 12 hours; rate-limit and free-plan counters are kept against a hash of your host name (monthly counts for about 40 days); daily usage counters with no site identifier are kept for up to 180 days. Please avoid pasting transcriptions or details of living relatives into a question.<\/p>\n\n<p>Terms: https:\/\/ancestorpress.com\/terms\/\nPrivacy: https:\/\/ancestorpress.com\/privacy-policy\/<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate AP Family Research from Plugins &gt; Add New, or upload it to <code>\/wp-content\/plugins\/<\/code>.<\/li>\n<li>Open <strong>AP Family Research<\/strong> in the admin menu. You can skip the opt-in screen.<\/li>\n<li>Capture items on the <strong>Inbox<\/strong> tab, or import a spreadsheet on the <strong>Import<\/strong> tab.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"can%20visitors%20see%20my%20research%3F\"><h3>Can visitors see my research?<\/h3><\/dt>\n<dd><p>No. The plugin has no front-end output, and it keeps captured files out of the REST API media listing, attachment pages and the media library for users who cannot manage it. As with any upload, someone who has a file's direct link can still open it.<\/p><\/dd>\n<dt id=\"will%20it%20change%20my%20data%3F\"><h3>Will it change my data?<\/h3><\/dt>\n<dd><p>No. Transcriptions are stored as typed, imports only add artefacts, and promoted dates are written as you entered them.<\/p><\/dd>\n<dt id=\"is%20the%20free%20version%20limited%3F\"><h3>Is the free version limited?<\/h3><\/dt>\n<dd><p>No. There is no cap, trial or time limit, and export always includes everything. One spreadsheet import can hold up to 20,000 rows.<\/p><\/dd>\n<dt id=\"does%20it%20need%20ap%20family%20trees%3F\"><h3>Does it need AP Family Trees?<\/h3><\/dt>\n<dd><p>No. Only linking artefacts to people and promoting conclusions need a family tree in the shared AncestorPress data.<\/p><\/dd>\n<dt id=\"does%20the%20help%20assistant%20see%20my%20research%3F\"><h3>Does the Help assistant see my research?<\/h3><\/dt>\n<dd><p>No. The Help button is optional and sends nothing until the site is connected and an administrator accepts its privacy notice. It then sends your question and counts of your records, never their contents, and it cannot change anything. See External services.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Hardening: every form field and upload the plugin receives, including the Help assistant's conversation, is now checked and cleaned as it arrives. Spreadsheet cells are cleaned the same way as the edit form. Transcriptions are still stored exactly as typed.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release: capture, spreadsheet import, artefact store, research questions, research log, tasks, promotion into your tree and full export.<\/li>\n<li>An optional Help assistant, described under External services.<\/li>\n<\/ul>","raw_excerpt":"The private research workbench behind your family tree: capture evidence, work your research questions, log every search, promote what you prove.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/370128","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=370128"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/ancestorpress"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=370128"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=370128"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=370128"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=370128"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=370128"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=370128"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}