[{"data":1,"prerenderedAt":421},["ShallowReactive",2],{"navigation":3,"\u002Freference\u002Fplugin-settings":88,"\u002Freference\u002Fplugin-settings-surround":416},[4,33,73],{"title":5,"path":6,"stem":7,"children":8,"icon":32},"Getting Started","\u002Fgetting-started","1.getting-started\u002F1.index",[9,12,17,22,27],{"title":10,"path":6,"stem":7,"icon":11},"Introduction","i-lucide-house",{"title":13,"path":14,"stem":15,"icon":16},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F2.installation","i-lucide-download",{"title":18,"path":19,"stem":20,"icon":21},"Connect a site","\u002Fgetting-started\u002Fconnect","1.getting-started\u002F3.connect","i-lucide-key",{"title":23,"path":24,"stem":25,"icon":26},"Usage","\u002Fgetting-started\u002Fusage","1.getting-started\u002F4.usage","i-lucide-sliders",{"title":28,"path":29,"stem":30,"icon":31},"Troubleshooting","\u002Fgetting-started\u002Ftroubleshooting","1.getting-started\u002F5.troubleshooting","i-lucide-life-buoy",false,{"title":34,"path":35,"stem":36,"children":37,"page":32},"Reference","\u002Freference","2.reference",[38,43,48,53,58,63,68],{"title":39,"path":40,"stem":41,"icon":42},"What gets logged","\u002Freference\u002Fwhat-gets-logged","2.reference\u002F1.what-gets-logged","i-lucide-list-tree",{"title":44,"path":45,"stem":46,"icon":47},"WP-CLI","\u002Freference\u002Fcli","2.reference\u002F2.cli","i-lucide-terminal",{"title":49,"path":50,"stem":51,"icon":52},"Read API","\u002Freference\u002Fapi","2.reference\u002F3.api","i-lucide-database",{"title":54,"path":55,"stem":56,"icon":57},"Plans & limits","\u002Freference\u002Fplans-and-limits","2.reference\u002F4.plans-and-limits","i-lucide-credit-card",{"title":59,"path":60,"stem":61,"icon":62},"Plugin settings","\u002Freference\u002Fplugin-settings","2.reference\u002F5.plugin-settings","i-lucide-settings",{"title":64,"path":65,"stem":66,"icon":67},"Account API","\u002Freference\u002Faccount-api","2.reference\u002F6.account-api","i-lucide-key-round",{"title":69,"path":70,"stem":71,"icon":72},"Reseller accounts","\u002Freference\u002Freseller-accounts","2.reference\u002F7.reseller-accounts","i-lucide-infinity",{"title":74,"path":75,"stem":76,"children":77,"page":32},"AI","\u002Fai","3.ai",[78,83],{"title":79,"path":80,"stem":81,"icon":82},"MCP","\u002Fai\u002Fmcp","3.ai\u002F1.mcp","i-lucide-cpu",{"title":84,"path":85,"stem":86,"icon":87},"AI & your data","\u002Fai\u002Fai-and-your-data","3.ai\u002F2.ai-and-your-data","i-lucide-shield-check",{"id":89,"title":59,"body":90,"description":409,"extension":410,"links":411,"meta":412,"navigation":413,"path":60,"seo":414,"stem":61,"__hash__":415},"docs\u002F2.reference\u002F5.plugin-settings.md",{"type":91,"value":92,"toc":401},"minimark",[93,116,121,124,162,181,185,188,210,224,228,243,250,306,313,329,333,350,355,362,373,379,387,397],[94,95,96,97,101,102,105,106,109,110,115],"p",{},"Everything the plugin needs to configure lives on one screen: ",[98,99,100],"strong",{},"Tools →\nhelloLOG"," in WP-admin, in the ",[98,103,104],{},"Settings"," tab (the same page also has a\n",[98,107,108],{},"Logs"," tab — see ",[111,112,114],"a",{"href":113},"\u002Fgetting-started\u002Fusage#reading-logs-in-wp-admin","Reading logs in WP-admin",").\nSettings has three tabs.",[117,118,120],"h2",{"id":119},"connection","Connection",[94,122,123],{},"Where the site key lives.",[125,126,127,150,156],"ul",{},[128,129,130,133,134,140,141,144,145,149],"li",{},[98,131,132],{},"API key"," — paste the key from the ",[111,135,139],{"href":136,"rel":137},"https:\u002F\u002Fapp.hellolog.io",[138],"nofollow","dashboard","\nand click ",[98,142,143],{},"Save API key",". The field shows the last four characters of\nwhatever's currently stored (",[146,147,148],"code",{},"••••ab12","); leaving it blank on save keeps\nthe existing key.",[128,151,152,155],{},[98,153,154],{},"Send test event"," — fires a one-off event straight to the backend,\nbypassing the queue. This is the only thing that flips a saved key to\nactive — saving alone stores it but leaves sensors detached until a test\nevent succeeds.",[128,157,158,161],{},[98,159,160],{},"Remove API key"," — clears the stored key and detaches sensors\nimmediately. Asks for confirmation first, since every event from the\nsite is rejected until a new key is saved.",[94,163,164,165,168,169,172,173,176,177,180],{},"WP-CLI equivalents: ",[146,166,167],{},"wp hellolog set-token \u003Ctoken>",", ",[146,170,171],{},"wp hellolog test",",\n",[146,174,175],{},"wp hellolog clear-token"," — see the ",[111,178,179],{"href":45},"full command reference",".",[117,182,184],{"id":183},"filters","Filters",[94,186,187],{},"What gets recorded.",[125,189,190,204],{},[128,191,192,195,196,199,200,203],{},[98,193,194],{},"Anonymize client IPs"," — strips the lowest byte before an IP leaves\nthe site (",[146,197,198],{},"\u002F24"," for IPv4, ",[146,201,202],{},"\u002F48"," for IPv6). Off by default.",[128,205,206,209],{},[98,207,208],{},"Sensors"," — every registered sensor, toggled individually. Turning one\noff means its hooks never even register, not just that events get\ndiscarded afterward. A search box filters the list by key or label.",[94,211,164,212,215,216,219,220,223],{},[146,213,214],{},"wp hellolog sensors"," (list, with enabled state),\n",[146,217,218],{},"wp hellolog enable-sensor \u003Ckey>"," \u002F ",[146,221,222],{},"wp hellolog disable-sensor \u003Ckey>",".\nIP anonymization has no CLI toggle — it's Settings-only.",[117,225,227],{"id":226},"diagnostics","Diagnostics",[94,229,230,231,234,235,238,239,242],{},"Read-only view of the local queue: current counts for ",[98,232,233],{},"Pending","\n(waiting for the next flush), ",[98,236,237],{},"Sending"," (claimed by the worker, not yet\nacknowledged) and ",[98,240,241],{},"Dead"," (hit max retries or a permanent failure), plus\na reminder that the queue table drains every 60 seconds on its own.",[94,244,245,246,249],{},"There's no button here to act on a ",[146,247,248],{},"dead"," pile — that's a CLI-only\noperation:",[251,252,258],"pre",{"className":253,"code":254,"filename":255,"language":256,"meta":257,"style":257},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","wp hellolog status            # same counts, from the terminal\nwp hellolog requeue-dead      # dead -> pending\nwp hellolog flush             # send them now instead of waiting\n","Terminal","bash","",[146,259,260,280,293],{"__ignoreMap":257},[261,262,265,269,273,276],"span",{"class":263,"line":264},"line",1,[261,266,268],{"class":267},"sBMFI","wp",[261,270,272],{"class":271},"sfazB"," hellolog",[261,274,275],{"class":271}," status",[261,277,279],{"class":278},"sHwdD","            # same counts, from the terminal\n",[261,281,283,285,287,290],{"class":263,"line":282},2,[261,284,268],{"class":267},[261,286,272],{"class":271},[261,288,289],{"class":271}," requeue-dead",[261,291,292],{"class":278},"      # dead -> pending\n",[261,294,296,298,300,303],{"class":263,"line":295},3,[261,297,268],{"class":267},[261,299,272],{"class":271},[261,301,302],{"class":271}," flush",[261,304,305],{"class":278},"             # send them now instead of waiting\n",[94,307,308,309,312],{},"See ",[111,310,28],{"href":311},"\u002Fgetting-started\u002Ftroubleshooting#events-arent-appearing","\nfor the full recovery walkthrough.",[314,315,317],"callout",{"icon":316},"i-lucide-lock",[94,318,319,320,322,323,326,327,180],{},"The ",[98,321,108],{}," tab next to Settings needs a paid plan — Free shows a card\nlinking to the ",[111,324,139],{"href":136,"rel":325},[138]," instead of the events\ntable. See ",[111,328,54],{"href":55},[117,330,332],{"id":331},"updates","Updates",[94,334,335,336,341,342,345,346,349],{},"The plugin updates itself from our\n",[111,337,340],{"href":338,"rel":339},"https:\u002F\u002Fgithub.com\u002Fhellolog-io\u002Fhellolog-plugin\u002Freleases",[138],"GitHub releases",":\nwhen a new version is published, it shows up on the ",[98,343,344],{},"Plugins"," screen\nlike any other plugin update — one click and you're current. The check\nruns against the latest release at most twice a day and only ever\ninstalls the official release asset from the\n",[146,347,348],{},"hellolog-io\u002Fhellolog-plugin"," repository.",[351,352,354],"h3",{"id":353},"turning-the-built-in-updater-off","Turning the built-in updater off",[94,356,357,358,361],{},"Managed setups that deploy plugins from version control or a central\ntool can disable the updater entirely with one filter (in a mu-plugin\nor your theme's ",[146,359,360],{},"functions.php","):",[251,363,367],{"className":364,"code":365,"filename":360,"language":366,"meta":257,"style":257},"language-php shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","add_filter( 'hellolog_self_update', '__return_false' );\n","php",[146,368,369],{"__ignoreMap":257},[261,370,371],{"class":263,"line":264},[261,372,365],{},[94,374,375,376,378],{},"With the filter in place the plugin no longer offers updates anywhere —\nthe site has deliberately lost that capability. The ",[98,377,227],{}," tab\nthen shows a direct link to the newest build so manual installs stay a\ndownload away:",[251,380,385],{"className":381,"code":383,"language":384},[382],"language-text","https:\u002F\u002Fgithub.com\u002Fhellolog-io\u002Fhellolog-plugin\u002Freleases\u002Flatest\u002Fdownload\u002Fhellolog.zip\n","text",[146,386,383],{"__ignoreMap":257},[94,388,389,390,393,394,180],{},"That URL always points at the latest release's zip, ready for\n",[98,391,392],{},"Plugins → Add New → Upload Plugin"," or unzipping into\n",[146,395,396],{},"wp-content\u002Fplugins\u002F",[398,399,400],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":257,"searchDepth":264,"depth":282,"links":402},[403,404,405,406],{"id":119,"depth":282,"text":120},{"id":183,"depth":282,"text":184},{"id":226,"depth":282,"text":227},{"id":331,"depth":282,"text":332,"children":407},[408],{"id":353,"depth":295,"text":354},"The WP-admin settings screen — Connection, Filters and Diagnostics — and their WP-CLI equivalents.","md",null,{},{"icon":62},{"title":59,"description":409},"IhifzKHX6sLqFBXrvtoyXNm966R3ZjjWGrIJLldGzBU",[417,419],{"title":54,"path":55,"stem":56,"description":418,"icon":57,"children":-1},"What each plan includes — sites, retention, and fair use.",{"title":64,"path":65,"stem":66,"description":420,"icon":67,"children":-1},"Manage sites and read events across your whole account with an account key. Paid plans only.",1787524098038]