{"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-03T06:20:57","modified_gmt":"2026-09-03T06:20:57","slug":"ravanix","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/ravanix\/","author":23553503,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.2.1","stable_tag":"1.2.1","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-03 06:20:57","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":132,"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}},"upgrade_notice":{"1.2.1":"<p>Recommended if you set a custom Brand color: fixes a real WCAG contrast failure that could make button text hard to read.<\/p>","1.2.0":"<p>Visual refresh only (Material Design 3-inspired front-end + adjustable brand color); no database changes, safe to update.<\/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"],"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":"Create and customize psychological questionnaires.","2":"Configure Ravanix settings.","3":"Track pre-test and post-test results with a progress chart.","4":"View the user's psychological profile.","5":"Import and export psychological questionnaires."}},"plugin_section":[],"plugin_tags":[18559,277835,278646,16919,42698],"plugin_category":[],"plugin_contributors":[277836],"plugin_business_model":[],"class_list":["post-357522","plugin","type-plugin","status-publish","hentry","plugin_tags-assessment","plugin_tags-psychological-test","plugin_tags-psychometric","plugin_tags-questionnaire","plugin_tags-scoring","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":"Create and customize psychological questionnaires."},{"src":"https:\/\/ps.w.org\/ravanix\/assets\/screenshot-2.png?rev=3668691","caption":"Configure Ravanix settings."},{"src":"https:\/\/ps.w.org\/ravanix\/assets\/screenshot-3.png?rev=3668691","caption":"Track pre-test and post-test results with a progress chart."},{"src":"https:\/\/ps.w.org\/ravanix\/assets\/screenshot-4.png?rev=3668691","caption":"View the user's psychological profile."},{"src":"https:\/\/ps.w.org\/ravanix\/assets\/screenshot-5.png?rev=3668691","caption":"Import and export psychological questionnaires."}],"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.2.0) is in changelog.txt.<\/p>\n\n<h4>1.2.1<\/h4>\n\n<ul>\n<li>Fixed: an admin-chosen brand color that was too light could fail WCAG AA text contrast; it's now automatically darkened only as much as actually needed, verified by a real contrast calculation (your saved setting is never changed)<\/li>\n<li>Fixed: dark mode's default button text also failed contrast against its own background (~2.6:1, well under the 4.5:1 minimum); now chosen by measuring actual contrast<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>New: the front-end pages (and Ravanix Pro's My Results dashboard) now use a Material Design 3-inspired look -- color roles, shape scale, type scale, and CSS-only state layers on buttons\/answers<\/li>\n<li>New: a \"Brand color\" setting (Ravanix Settings -&gt; Branding) re-tints the entire front-end palette from one chosen color, computed live in the browser (no extra library)<\/li>\n<li>New: automatic light\/dark appearance, following the visitor's OS\/browser preference<\/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:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/357522","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=357522"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/ravanix"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=357522"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=357522"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=357522"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=357522"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=357522"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=357522"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}