{"id":315464,"date":"2026-05-24T14:02:03","date_gmt":"2026-05-24T14:02:03","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/papertrail-ai-smart-document-library\/"},"modified":"2026-05-29T00:10:12","modified_gmt":"2026-05-29T00:10:12","slug":"ask-adam-doc-it","status":"publish","type":"plugin","link":"https:\/\/hsb.wordpress.org\/plugins\/ask-adam-doc-it\/","author":18772735,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.2.2","stable_tag":"1.2.2","tested":"7.0","requires":"7.0","requires_php":"7.4","requires_plugins":null,"header_name":"Ask Adam Doc It","header_author":"Ask Adam","header_description":"AI-powered document library for WordPress. Upload, organize, and semantically search files using OpenAI embeddings.","assets_banners_color":"4e9097","last_updated":"2026-05-29 00:10:12","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/jackofall1232\/ask-adam-doc-it","header_author_uri":"https:\/\/askadamit.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":144,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"jackofall1232","date":"2026-05-24 14:00:13"},"1.2.1":{"tag":"1.2.1","author":"jackofall1232","date":"2026-05-28 23:13:09"},"1.2.2":{"tag":"1.2.2","author":"jackofall1232","date":"2026-05-29 00:10:12"}},"upgrade_notice":{"1.2.2":"<p>Embeddings now pick up the OpenAI API key automatically from the WordPress 7.0 Connectors API. If the AI Provider for OpenAI plugin is configured under Settings \u2192 Connectors, documents will generate embeddings with no manual key entry.<\/p>","1.2.1":"<p>Fixes a &quot;Publishing failed&quot; JSON error in the block editor when an AI provider is connected. Recommended for all 1.2.0 users.<\/p>","1.2.0":"<p>Requires WordPress 7.0. AI features now use the built-in AI Client \u2014 remove your old API key worries and configure an AI provider under Settings \u2192 Connectors instead.<\/p>","1.1.0":"<p>Adds optional AI document summarization. Enable it under Settings \u2192 AI Configuration after upgrading.<\/p>","1.0.1":"<p>Refreshed admin settings page with branded teal hero, tabbed layout, and help tab.<\/p>","1.0.0":"<p>Initial release.<\/p>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3546308,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":3546308,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"ask-adam-doc-it\/library":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"ask-adam-doc-it\/library","title":"Ask Adam Doc It Library","description":"Display your document library with optional AI search.","category":"widgets","icon":"media-document","supports":{"html":false,"align":["wide","full"]},"textdomain":"ask-adam-doc-it","attributes":{"category":{"type":"string","default":""},"perPage":{"type":"number","default":10},"showSearch":{"type":"boolean","default":true},"columns":{"type":"number","default":1,"enum":[1,2]},"mode":{"type":"string","default":"auto","enum":["auto","ai","core"]}},"editorScript":"file:.\/index.js","viewScript":"ask-adam-doc-it-public","style":"ask-adam-doc-it-public"}},"tagged_versions":["1.0.0","1.2.1","1.2.2"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":3552870,"resolution":"1","location":"assets","locale":"","width":2560,"height":999},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3552870,"resolution":"2","location":"assets","locale":"","width":1536,"height":2222},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3552870,"resolution":"4","location":"assets","locale":"","width":1446,"height":1002},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3552870,"resolution":"5","location":"assets","locale":"","width":1972,"height":1205},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3552870,"resolution":"6","location":"assets","locale":"","width":1975,"height":1191},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3552870,"resolution":"7","location":"assets","locale":"","width":1989,"height":1149}},"screenshots":{"1":"The document library admin list view with file type, size, and download statistics columns.","2":"The settings page with AI summary toggle and upload size configuration.","3":"The frontend document library shortcode output with search and AI-mode results."}},"plugin_section":[],"plugin_tags":[259736,220145,24392,8848,1764],"plugin_category":[],"plugin_contributors":[249752],"plugin_business_model":[],"class_list":["post-315464","plugin","type-plugin","status-publish","hentry","plugin_tags-ai-client","plugin_tags-ai-search","plugin_tags-document-library","plugin_tags-file-manager","plugin_tags-pdf","plugin_contributors-jackofall1232","plugin_committers-jackofall1232"],"banners":{"banner":"https:\/\/ps.w.org\/ask-adam-doc-it\/assets\/banner-772x250.png?rev=3546308","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/ask-adam-doc-it\/assets\/icon-256x256.png?rev=3546308","icon_2x":"https:\/\/ps.w.org\/ask-adam-doc-it\/assets\/icon-256x256.png?rev=3546308","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/ask-adam-doc-it\/assets\/screenshot-1.jpg?rev=3552870","caption":"The document library admin list view with file type, size, and download statistics columns."},{"src":"https:\/\/ps.w.org\/ask-adam-doc-it\/assets\/screenshot-2.png?rev=3552870","caption":"The settings page with AI summary toggle and upload size configuration."},{"src":"https:\/\/ps.w.org\/ask-adam-doc-it\/assets\/screenshot-4.png?rev=3552870","caption":""},{"src":"https:\/\/ps.w.org\/ask-adam-doc-it\/assets\/screenshot-5.png?rev=3552870","caption":""},{"src":"https:\/\/ps.w.org\/ask-adam-doc-it\/assets\/screenshot-6.png?rev=3552870","caption":""},{"src":"https:\/\/ps.w.org\/ask-adam-doc-it\/assets\/screenshot-7.png?rev=3552870","caption":""}],"raw_content":"<!--section=description-->\n<p>Ask Adam Doc It is a free-forever document library for WordPress. Upload PDFs, Word documents, spreadsheets, images, and any other file types your media library accepts, then organize them with categories and surface them with a shortcode, a Gutenberg block, or built-in archive templates.<\/p>\n\n<p>AI features are powered by the WordPress 7.0 built-in AI Client (<code>wp_ai_client_prompt()<\/code>). There is no API key to configure in the plugin \u2014 install and configure an AI provider plugin (such as AI Provider for OpenAI) under Settings \u2192 Connectors, and semantic search and document summaries light up automatically. The plugin works fully without any AI provider; AI is purely optional.<\/p>\n\n<p>Ask Adam Doc It is part of the <strong>Ask Adam<\/strong> suite by <a href=\"https:\/\/askadamit.com\">askadamit.com<\/a>. The free plugin is feature-complete on its own. If you want conversational document Q&amp;A, multi-document context retrieval, bulk indexing, and analytics, those live in Ask Adam Pro at <a href=\"https:\/\/askadamit.com\/purchase\">askadamit.com\/purchase<\/a> \u2014 a separate product.<\/p>\n\n<h4>What's included (free)<\/h4>\n\n<ul>\n<li>Dedicated \"Files\" custom post type for documents<\/li>\n<li>Categories and tags for organizing your library<\/li>\n<li>Frontend archive and single views with theme-overridable templates<\/li>\n<li><code>[ask_adam_doc_it]<\/code> shortcode and a matching Gutenberg block<\/li>\n<li>Classic keyword search across your library<\/li>\n<li>Optional AI-powered semantic search via the WordPress 7.0 AI Client<\/li>\n<li>Admin columns and meta boxes for quick file management<\/li>\n<li>Clean uninstall with an opt-in \"delete my data\" switch<\/li>\n<\/ul>\n\n<p>There are no feature locks, license checks, or paid upgrades inside this plugin.<\/p>\n\n<h3>External Services<\/h3>\n\n<p>When an AI provider is configured through the WordPress 7.0 AI Client (Settings \u2192 Connectors), Ask Adam Doc It sends document summary text to that provider to generate on-demand summaries. When an OpenAI credential is available for embeddings (via an AI provider plugin or the <code>aadi_openai_api_key<\/code> filter), document summary text is also sent to the OpenAI API to generate search embeddings.<\/p>\n\n<p><strong>What data is sent:<\/strong><\/p>\n\n<ul>\n<li><em>Document metadata (admin-controlled):<\/em> The document title, excerpt, AI Search Summary field, and category names for each published document. The plugin does not intentionally collect or transmit WordPress account, profile, or visitor data, but because these fields are authored by site administrators, any personal information an admin types into them (for example, a person's name in a document title) will be sent to OpenAI as part of the embedding source text.<\/li>\n<li><em>Visitor search text (visitor-controlled):<\/em> When a visitor performs an AI search, the raw search query they typed is sent to OpenAI to generate a query embedding for semantic matching. The plugin cannot inspect this text in advance, so if visitors enter personal information (names, email addresses, etc.) it will be transmitted to OpenAI as part of the query. No IP address, user ID, cookie, or other identifier is attached to either request.<\/li>\n<\/ul>\n\n<p><strong>When data is sent:<\/strong> Document metadata is sent when a document is published or updated (via WP-Cron, a few seconds after save), or when an admin manually regenerates an embedding. Visitor search text is sent each time a visitor submits an AI-mode search.<\/p>\n\n<p><strong>This feature is entirely optional.<\/strong> The plugin works fully without any AI provider using keyword search.<\/p>\n\n<p><strong>Summaries:<\/strong> Sent to whichever AI provider you connect through the WordPress 7.0 AI Client (Settings \u2192 Connectors). The data-handling, privacy policy, and terms of that provider apply \u2014 review them for the connector you install (for example, AI Provider for OpenAI sends data to the OpenAI API).<\/p>\n\n<p><strong>Embeddings (semantic search):<\/strong> When an OpenAI credential is available, document summary text and visitor search queries are sent to the OpenAI API.<\/p>\n\n<p><strong>Service:<\/strong> OpenAI API (api.openai.com)\n<strong>Privacy Policy:<\/strong> <a href=\"https:\/\/openai.com\/privacy\">https:\/\/openai.com\/privacy<\/a>\n<strong>Terms of Service:<\/strong> <a href=\"https:\/\/openai.com\/terms\">https:\/\/openai.com\/terms<\/a><\/p>\n\n<p>No data is sent to any service when no AI provider is configured.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>ask-adam-doc-it<\/code> folder to <code>\/wp-content\/plugins\/<\/code>, or install via the Plugins screen in WordPress.<\/li>\n<li>Activate <strong>Ask Adam Doc It<\/strong> through the Plugins screen.<\/li>\n<li>(Optional) Install an AI provider plugin (such as AI Provider for OpenAI) and configure it under <strong>Settings \u2192 Connectors<\/strong> to enable semantic search and document summaries.<\/li>\n<li>Add your first document under <strong>Files \u2192 Add New<\/strong>.<\/li>\n<li>Embed the library anywhere with the <code>[ask_adam_doc_it]<\/code> shortcode or the Ask Adam Doc It block.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20it%20work%20without%20an%20ai%20provider%3F\"><h3>Does it work without an AI provider?<\/h3><\/dt>\n<dd><p>Yes. The plugin is fully functional with zero configuration. Without an AI provider you get a complete document library with classic keyword search. Configuring an AI provider through the WordPress 7.0 AI Client (Settings \u2192 Connectors) only enables the optional AI semantic search and summary layer.<\/p><\/dd>\n<dt id=\"is%20this%20really%20free%3F\"><h3>Is this really free?<\/h3><\/dt>\n<dd><p>Yes. Ask Adam Doc It is GPLv2-licensed and 100% free. There are no premium feature locks, no license keys, and no upsells embedded in functionality. The only paid product mentioned anywhere is a passive sidebar link to Ask Adam Pro, which is a completely separate product you can ignore.<\/p><\/dd>\n<dt id=\"how%20is%20it%20different%20from%20ask%20adam%20pro%3F\"><h3>How is it different from Ask Adam Pro?<\/h3><\/dt>\n<dd><p>Ask Adam Doc It is a self-contained WordPress document library that you host and control. Ask Adam Pro (sold separately at askadamit.com\/purchase) is a broader product that adds conversational document Q&amp;A, multi-document context retrieval with citations, bulk embedding tools, analytics, and priority support. The two work well together but neither requires the other.<\/p><\/dd>\n<dt id=\"what%20file%20types%20are%20supported%3F\"><h3>What file types are supported?<\/h3><\/dt>\n<dd><p>Any file type your WordPress media library accepts can be attached to an Ask Adam Doc It file entry, including PDFs, Word documents (.doc\/.docx), spreadsheets (.xls\/.xlsx\/.csv), presentations (.ppt\/.pptx), images (.jpg\/.png\/.gif\/.webp), and plain text files. You can extend supported MIME types using the standard <code>upload_mimes<\/code> WordPress filter. SVG is intentionally excluded \u2014 it is a stored XSS vector. SVG support requires dedicated sanitization \u2014 available in Pro.<\/p><\/dd>\n<dt id=\"is%20ask%20adam%20doc%20it%20available%20in%20my%20language%3F\"><h3>Is Ask Adam Doc It available in my language?<\/h3><\/dt>\n<dd><p>Ask Adam Doc It is translation-ready. A .pot file is included in the languages\/ folder. If you would like to contribute a translation, please get in touch via https:\/\/askadamit.com\/contact.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.2.2<\/h4>\n\n<ul>\n<li>Fixed: Embeddings now retrieve the OpenAI API key from the WordPress 7.0 Connectors API (connectors_ai_openai_api_key option) automatically. Documents will generate embeddings as long as the AI Provider for OpenAI plugin is configured under Settings \u2192 Connectors \u2014 no manual key entry needed.<\/li>\n<\/ul>\n\n<h4>1.2.1<\/h4>\n\n<ul>\n<li>Fixed: Block editor \"Publishing failed\" error caused by AI Client initialization running during REST API requests.<\/li>\n<li>Fixed: Document Summary meta box label and description updated to reflect that manual input is optional \u2014 the AI Summarize button reads the attached file directly.<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>Changed: Migrated to WordPress 7.0 built-in AI Client. AI features now use wp_ai_client_prompt() \u2014 no API key configuration needed in plugin settings. Install and configure an AI provider plugin (such as AI Provider for OpenAI) under Settings \u2192 Connectors.<\/li>\n<li>Removed: OpenAI API key field from plugin settings.<\/li>\n<li>Removed: Circuit breaker and base64 key storage.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>New: Optional AI Summarize button on document cards and single document pages. When enabled in Settings, visitors can request a plain-English 2-3 sentence summary of any document on demand before downloading.<\/li>\n<li>Summaries are generated via OpenAI GPT and cached for one week per document \u2014 repeat clicks serve instantly from cache with no additional API cost.<\/li>\n<li>Rate limited to 30 fresh generations per hour site-wide to prevent API abuse.<\/li>\n<li>Button hidden automatically when AI is disabled or the OpenAI circuit breaker is tripped.<\/li>\n<li>Password-protected documents cannot be summarized by anonymous visitors.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Branded admin UI with teal hero, tabbed settings, and help documentation tab.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<li><code>aadi_file<\/code> custom post type and <code>aadi_category<\/code> taxonomy.<\/li>\n<li>Classic keyword search across the document library.<\/li>\n<li>Optional AI semantic search via OpenAI embeddings (bring your own API key).<\/li>\n<li><code>[ask_adam_doc_it]<\/code> shortcode and matching Gutenberg block.<\/li>\n<li>Admin meta boxes, list-table columns, and settings page.<\/li>\n<li>Theme-overridable archive and single templates.<\/li>\n<li>Opt-in clean uninstall.<\/li>\n<\/ul>","raw_excerpt":"Free WordPress document library with optional AI semantic search powered by the WordPress 7.0 built-in AI Client. Part of the Ask Adam suite.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/hsb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/315464","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/hsb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/hsb.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/hsb.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=315464"}],"author":[{"embeddable":true,"href":"https:\/\/hsb.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/jackofall1232"}],"wp:attachment":[{"href":"https:\/\/hsb.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=315464"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/hsb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=315464"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/hsb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=315464"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/hsb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=315464"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/hsb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=315464"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/hsb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=315464"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}