{"id":357522,"date":"2026-08-27T11:32:18","date_gmt":"2026-08-27T11:32:18","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/ravanix-smart-psychological-assessment\/"},"modified":"2026-09-07T02:58:47","modified_gmt":"2026-09-07T02:58:47","slug":"ravanix","status":"publish","type":"plugin","link":"https:\/\/tg.wordpress.org\/plugins\/ravanix\/","author":23553503,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.3.2","stable_tag":"1.3.2","tested":"7.1","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Ravanix \u2013 Smart Psychological Assessment","header_author":"Ravanix","header_description":"Free plugin to build and run psychological questionnaires (personality, clinical, screening) with a dynamic scoring engine, automatic result interpretation, and a charted psychological profile. Professional features (norms, composite factors, PDF, import\/export, and more) are added by the companion Ravanix Pro plugin.","assets_banners_color":"c7c8d5","last_updated":"2026-09-07 02:58:47","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/psykey.ir","header_author_uri":"https:\/\/psykey.ir","rating":0,"author_block_rating":0,"active_installs":0,"downloads":173,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.11":{"tag":"1.0.11","author":"ravanix","date":"2026-08-27 11:31:43","revision":3668691},"1.1.5":{"tag":"1.1.5","author":"ravanix","date":"2026-09-01 10:34:50","revision":3675870},"1.2.1":{"tag":"1.2.1","author":"ravanix","date":"2026-09-03 06:20:57","revision":3679088},"1.3.2":{"tag":"1.3.2","author":"ravanix","date":"2026-09-07 02:58:47","revision":3684105}},"upgrade_notice":{"1.3.2":"<p>Recommended: faster loading for large questionnaires, safer background site updates, and several accessibility\/security fixes. No database changes.<\/p>","1.3.1":"<p>Recommended: fixes horizontal-scroll layout issues on several admin tabs.<\/p>","1.3.0":"<p>Recommended: fixes dark-mode readability that 1.2.3 missed on three pages, plus a horizontal-overflow bug on the Dimensions admin tab.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3668691,"resolution":"128x128","location":"assets","locale":"","width":125,"height":125},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3668691,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500-rtl.png":{"filename":"banner-1544x500-rtl.png","revision":3668691,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3668691,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250-rtl.png":{"filename":"banner-772x250-rtl.png","revision":3668691,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3668691,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"ravanix\/questionnaire":{"name":"ravanix\/questionnaire","title":"Ravanix \u2013 Questionnaire"}},"tagged_versions":["1.0.11","1.1.5","1.2.1","1.3.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3668691,"resolution":"1","location":"assets","locale":"","width":1590,"height":777},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3668691,"resolution":"2","location":"assets","locale":"","width":1763,"height":844},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3668691,"resolution":"3","location":"assets","locale":"","width":1193,"height":858},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3668691,"resolution":"4","location":"assets","locale":"","width":986,"height":881},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3668691,"resolution":"5","location":"assets","locale":"","width":1663,"height":788}},"screenshots":{"1":"Test builder panel and dimension setup","2":"Test form on the front end","3":"Psychological profile display with a bar chart"}},"plugin_section":[],"plugin_tags":[18559,71260,278646,16919],"plugin_category":[],"plugin_contributors":[277836],"plugin_business_model":[],"class_list":["post-357522","plugin","type-plugin","status-publish","hentry","plugin_tags-assessment","plugin_tags-psychological","plugin_tags-psychometric","plugin_tags-questionnaire","plugin_contributors-ravanix","plugin_committers-ravanix"],"banners":{"banner":"https:\/\/ps.w.org\/ravanix\/assets\/banner-772x250.png?rev=3668691","banner_2x":"https:\/\/ps.w.org\/ravanix\/assets\/banner-1544x500.png?rev=3668691","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/ravanix\/assets\/icon-128x128.png?rev=3668691","icon_2x":"https:\/\/ps.w.org\/ravanix\/assets\/icon-256x256.png?rev=3668691","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/ravanix\/assets\/screenshot-1.png?rev=3668691","caption":"Test builder panel and dimension setup"},{"src":"https:\/\/ps.w.org\/ravanix\/assets\/screenshot-2.png?rev=3668691","caption":"Test form on the front end"},{"src":"https:\/\/ps.w.org\/ravanix\/assets\/screenshot-3.png?rev=3668691","caption":"Psychological profile display with a bar chart"},{"src":"https:\/\/ps.w.org\/ravanix\/assets\/screenshot-4.png?rev=3668691","caption":""},{"src":"https:\/\/ps.w.org\/ravanix\/assets\/screenshot-5.png?rev=3668691","caption":""}],"raw_content":"<!--section=description-->\n<p>Ravanix is a free, dynamic engine for building, managing, and running\npsychological questionnaires in WordPress. Site admins can design any kind\nof test (personality, clinical, screening, satisfaction surveys, etc.) with\ncustom dimensions (subscales), multiple question types (5- and 7-point\nLikert, yes\/no, custom multiple-choice), reverse scoring, and custom\ninterpretation ranges. Once a user completes a test, they see their\npsychological profile along with a bar chart and an interpretive\ndescription for each dimension, and the admin can view every participant's\nresults in the admin panel.<\/p>\n\n<h4>Key features (free, in this plugin)<\/h4>\n\n<ul>\n<li>A fully dynamic test builder: any number of tests, each with custom dimensions and questions<\/li>\n<li>Question types: 5- and 7-point Likert, yes\/no, custom multiple-choice with any numeric value<\/li>\n<li>Reverse scoring and an importance weight for each question<\/li>\n<li>Definable interpretation ranges per dimension, with a custom description<\/li>\n<li>Branching \/ skip logic: show a question only if an earlier one was answered a specific way<\/li>\n<li>Informed consent: a site-wide or per-test notice the participant must expand and agree to before starting<\/li>\n<li>Save &amp; Resume: answers always autosave in-browser; an optional button also lets a logged-in participant resume on another device<\/li>\n<li>Display a test via shortcode, or as its own custom-post-type page with an SEO-friendly slug, tags, and categories<\/li>\n<li>The WordPress classic editor for test, dimension, and consent-notice text<\/li>\n<li>Bulk paste-import of questions and answer options; pagination with a progress bar for long questionnaires<\/li>\n<li>Configurable participant fields (name, education, mobile, email, age, gender)<\/li>\n<li>A Material Design 3-inspired look on the front-end, with an adjustable brand color and automatic light\/dark appearance<\/li>\n<li>Bar chart for results with Chart.js (bundled locally, no external CDN)<\/li>\n<li>An admin panel to review every participant's results<\/li>\n<li>Anti-spam protection (honeypot field, minimum completion time, rate limiting)<\/li>\n<li>Displays correctly in RTL (e.g. Persian\/Arabic) or LTR, automatically following the site's language; fully translation-ready (i18n)<\/li>\n<li>WordPress Erase Personal Data integration, plus an opt-in \"delete all data on uninstall\" setting<\/li>\n<\/ul>\n\n<h4>Ravanix Pro<\/h4>\n\n<p>A separate, paid companion plugin, <strong>Ravanix Pro<\/strong>, is available from\n<a href=\"https:\/\/psykey.ir\">psykey.ir<\/a> and adds: T\/Z scores and percentile rank from\nnorm tables, composite (higher-order) factor scores, validity scales,\nforced-choice\/ipsative questions, PDF and CSV\/Excel export, full JSON\nimport\/export, execution limits and access codes, WooCommerce integration,\nand a \"My Results\" dashboard with a timeline chart. Ravanix Pro requires\nthis plugin to be installed and active; it is not hosted on WordPress.org.\nSee the \"Upgrade to Pro\" page in the plugin's own menu for a full comparison.<\/p>\n\n<h4>Important note about standardized instruments (NEO, Millon, Beck, MMPI, etc.)<\/h4>\n\n<p>The items, official scoring keys, and norms of standardized, copyrighted\ninstruments (NEO-PI-R, MMPI, Millon CMI, the original Beck inventories,\netc.) belong to their publishers and are not included in this plugin. With\nlegitimate, licensed access to such an instrument, you can enter its items,\nscoring, and interpretive keys yourself; the plugin only provides the\ntechnical infrastructure.<\/p>\n\n<h3>Privacy<\/h3>\n\n<p>For a guest participant: a <code>ravanix_guest_token<\/code> cookie (random ID, 3-year\nlifetime) and the submitting IP are stored with each result, solely for\nanti-spam rate-limiting and letting that guest resume an in-progress test.\nNothing is sent to any external server. A logged-in participant using\n\"Save my progress\" (if enabled for that test) also has in-progress answers\nstored server-side until the test is completed or restarted.<\/p>\n\n<p>Participant info fields (name, email, etc.) are only collected if the\nadmin turns them on. See the FAQ for uninstall data deletion and\nWordPress's Erase Personal Data tool for logged-in users.<\/p>\n\n<h3>Technical Note<\/h3>\n\n<p>Chart.js is bundled locally (no external CDN). The source translation\nfile is at languages\/ravanix.pot; use Poedit or Loco Translate to build\n.po\/.mo files for your language from it.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin folder to wp-content\/plugins, or from the WordPress\ndashboard, go to Plugins &gt; Add New &gt; Upload Plugin and upload the zip file.<\/li>\n<li>Activate the plugin.<\/li>\n<li>A short sample questionnaire is created automatically so you can see how\nit works; create your own test from the \"Ravanix\" menu.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20the%20plugin%20include%20items%20from%20standardized%20tests%20like%20the%20neo%20or%20the%20beck%20inventory%3F\"><h3>Does the plugin include items from standardized tests like the NEO or the Beck inventory?<\/h3><\/dt>\n<dd><p>No. These instruments are copyrighted. The plugin only provides the\ntechnical infrastructure (scoring engine, display, and interpretation), and\nyou enter the items yourself from your own official, licensed source.<\/p><\/dd>\n<dt id=\"can%20a%20test%20be%20displayed%20on%20its%20own%20dedicated%20page%20with%20its%20own%20url%3F\"><h3>Can a test be displayed on its own dedicated page with its own URL?<\/h3><\/dt>\n<dd><p>Yes. In the plugin settings you can enable \"Display as a custom post type\"\nso that, in addition to the shortcode, each test also gets its own URL.<\/p><\/dd>\n<dt id=\"can%20i%20build%20a%20right-to-left%20%28e.g.%20persian%20or%20arabic%29%20questionnaire%3F\"><h3>Can I build a right-to-left (e.g. Persian or Arabic) questionnaire?<\/h3><\/dt>\n<dd><p>Yes. A test's display direction (RTL or LTR) automatically follows the\nsite's active language (WordPress's own is_rtl()) \u2014 for example, a test\ndisplays RTL on a site running in Persian or Arabic, and LTR on a site\nrunning in English. This is site-wide, not a per-test choice. The plugin's\nown interface strings are in English and fully translation-ready (a .pot\nfile is included; community translations can be contributed via\ntranslate.wordpress.org once the plugin is published).<\/p><\/dd>\n<dt id=\"can%20i%20require%20participants%20to%20agree%20to%20a%20consent%20notice%20before%20starting%3F\"><h3>Can I require participants to agree to a consent notice before starting?<\/h3><\/dt>\n<dd><p>Yes. Set a default notice in Ravanix Settings, or a custom one per test (or\nturn it off) in that test's settings. Shown collapsed with an \"I agree\"\ncheckbox required before \"Start Test\", verified server-side too.<\/p><\/dd>\n<dt id=\"can%20a%20long%20questionnaire%20be%20saved%20and%20finished%20later%3F\"><h3>Can a long questionnaire be saved and finished later?<\/h3><\/dt>\n<dd><p>Yes. Answers always autosave in the browser. For long tests, you can also\nturn on a visible \"Save my progress\" button per test, letting a logged-in\nparticipant resume on a different device.<\/p><\/dd>\n<dt id=\"can%20a%20question%20be%20shown%20only%20if%20an%20earlier%20question%20was%20answered%20a%20certain%20way%3F\"><h3>Can a question be shown only if an earlier question was answered a certain way?<\/h3><\/dt>\n<dd><p>Yes, via each question's \"show this question only if\" setting: pick an\nearlier question and the required answer value. A hidden question isn't\nrequired and is excluded from its dimension's score, like any unanswered one.<\/p><\/dd>\n<dt id=\"what%20happens%20to%20my%20data%20if%20i%20delete%20the%20plugin%3F\"><h3>What happens to my data if I delete the plugin?<\/h3><\/dt>\n<dd><p>By default, nothing is deleted; your questionnaires, results, and settings\nstay in the database and come back if you reinstall Ravanix later. To\npermanently delete everything instead, enable \"Delete data on uninstall\" in\nthe Danger zone section of Ravanix Settings before removing the plugin \u2014\nthis cannot be undone, and never deletes Media Library images.<\/p><\/dd>\n<dt id=\"can%20a%20logged-in%20participant%20ask%20for%20their%20data%20to%20be%20removed%3F\"><h3>Can a logged-in participant ask for their data to be removed?<\/h3><\/dt>\n<dd><p>Yes, via WordPress's own Tools -&gt; Erase Personal Data for any request tied\nto a registered user's email. Ravanix removes that user's identifying\ndetails (name, contact info, individual answers) while keeping the\nresulting dimension scores as anonymous data points, so site-wide\nstatistics aren't affected. This only covers logged-in users, since a guest\nsubmission has no account\/email for WordPress's privacy tools to look up.<\/p><\/dd>\n<dt id=\"what%27s%20the%20difference%20between%20ravanix%20and%20ravanix%20pro%3F\"><h3>What's the difference between Ravanix and Ravanix Pro?<\/h3><\/dt>\n<dd><p>Ravanix (this plugin) is fully functional on its own. Ravanix Pro is a\nseparate, paid add-on for professional\/research use (norm-based scoring,\ncomposite factors, validity scales, PDF\/CSV export, data portability,\naccess control, selling access to tests). See \"Upgrade to Pro\" in the\nplugin's menu for a full comparison.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<p>Full history (every release before 1.3.0) is in changelog.txt.<\/p>\n\n<h4>1.3.2<\/h4>\n\n<ul>\n<li>Improved: loading a test's full structure (dimensions, questions, options, interpretations, norms, composites) now uses a fixed, small number of batched database queries instead of one query per dimension\/question\/composite, and the result is cached \u2014 noticeably faster on large questionnaires (200+ items), with no change to stored data or behavior<\/li>\n<li>Improved: activating\/updating the plugin on a site with many existing questionnaires no longer risks a timeout re-syncing the custom-post-type mirror for every one of them in a single request; on larger sites this now finishes in the background instead<\/li>\n<li>Security: the anonymous-participant token (used to let a guest view their own result later) is now generated with PHP's cryptographic random-number source rather than a general-purpose password generator; a token issued before this update keeps working unchanged<\/li>\n<li>Fixed: an admin-chosen interpretation-range color that was light could make the fixed white badge text (result page, admin result view, PDF\/CSV reports) hard to read; it now gets the same automatic WCAG-AA contrast check already applied to the brand color, computed fresh each time rather than stored<\/li>\n<li>Fixed: the \"Add New...\" \/ list two-column layout shared by the Dimensions, Questions, and Interpretation Ranges tabs used a fixed-pixel form column next to a flex-grow list column, which became visibly unbalanced on wide screens (the form column stayed a small fixed width while the list column claimed all the rest); it's now a CSS Grid with a fixed 40%\/60% split that holds steady at any screen width<\/li>\n<li>Fixed: the Questions and Interpretation Ranges tables could overflow their column and the page instead of scrolling internally, the same issue already fixed on the Dimensions tab in a previous release; now consistent across all three tabs<\/li>\n<li>Fixed: two colors used on the \"Upgrade to Pro\" admin screen (the button, and the \u2713\/\u2715 icons in the comparison table) measured below WCAG AA contrast against their background<\/li>\n<li>Fixed: a database error while saving a test was shown to the admin with the raw SQL error text; it's now a generic message, with the real error going to the debug log instead<\/li>\n<\/ul>\n\n<h4>1.3.1<\/h4>\n\n<ul>\n<li>Fixed: several admin tabs (Dimensions, Questions, Interpretation Ranges, and Ravanix Pro's Norms and Composite Factors) needed horizontal scrolling on their main table; the \"Add New...\" form column next to it is now 20% narrower and no longer expands to steal that space<\/li>\n<\/ul>\n\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>New: test intro now shows question count, estimated time, and total participants so far, each with its own icon (replaces the old plain \"Number of questions\" text)<\/li>\n<li>Improved: \"Start Test\" and \"Submit answers\" buttons are noticeably larger and more prominent<\/li>\n<\/ul>","raw_excerpt":"Build, run, and score psychological questionnaires in WordPress with charted profiles and automatic result interpretation.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/tg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/357522","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/tg.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/tg.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=357522"}],"author":[{"embeddable":true,"href":"https:\/\/tg.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/ravanix"}],"wp:attachment":[{"href":"https:\/\/tg.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=357522"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/tg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=357522"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/tg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=357522"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/tg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=357522"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/tg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=357522"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/tg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=357522"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}