=== Plugin Name === Contributors: cfkurtz, pdfernhout Plugin Name: NarraFirma Plugin URI: https://www.narrafirma.com Tags: stories, narrative, inquiry, survey, social, research, organizations, communities, conflict, participation, PNI Author URI: http://www.cfkurtz.com Author: Cynthia Kurtz and Paul Fernhout Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=DGVVDT2D49QA8 Requires at least: 4.3.1 Tested up to: 5.0.3 Stable tag: trunk Version: 1.2.2 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Participatory Narrative Inquiry in a box. Gather stories and make sense of challenges and opportunities in your community or organization. == Description == NarraFirma is companion software to the textbook [Working with Stories in Your Community Or Organization: Participatory Narrative Inquiry](http://www.workingwithstories.org). Participatory narrative inquiry is an approach in which groups of people participate in gathering and working with raw stories of personal experience in order to make sense of complex patterns for better decision making. PNI focuses on the profound consideration of values, beliefs, feelings, and perspectives through the recounting and interpretation of lived experience. = What is NarraFirma? = * It's a checklist. NarraFirma provides practical guidance as you work, with questions for you to answer, recommendations based on the conditions you describe, activities that help you make decisions, and just-in-time advice. * It's a journal. NarraFirma helps you keep careful records about what happened in your project, and it gives you places to reflect on what happened. This reminds you to keep learning as you work, and it helps you to document your project for future reference. * It's a kiosk. NarraFirma helps you collect stories, on-line and/or off-line, based on question forms you design (with sample questions you can copy). Because story collection is integrated, there is no need to export or import data. * It's a workstation. NarraFirma helps you explore and interpret patterns in your data (stories and answers to questions about stories), creating annotated visualizations you can use to make sense of the stories you collected. = Why choose NarraFirma? = * It's portable. You can install NarraFirma anywhere, as a WordPress plugin or a Node.js web application. Web hosting is inexpensive, popular, and well supported. You can also install NarraFirma on your local computer and use it off-line. (Whichever installation method you choose, we strongly suggest that you set up SSL security on your web site before collecting or entering confidential or important information. Many hosting providers can help you with this task.) * It's a team player. With NarraFirma your team can work on projects together in real time without having to hand files back and forth. You can plan your project, collect stories, discover patterns, and reflect on what you've learned - together. * It's an open book. NarraFirma is open source software. So if you have a question about how something works, you can just look at the source code to find out. If you need the software to do something it can't do, you can add new functionality yourself or ask someone else to add it. * It works in the real world. One NarraFirma installation supports multiple projects, forms, data sets, and reports. Why? Because real-life story projects are rarely simple or predictable. So go ahead and make a mess. NarraFirma is ready for it. == Installation == To install NarraFirma: 1. Download the NarraFirma plugin (in zip format) from WordPress.org or the [NarraFirma web site](narrafirma.com). 2. In your WordPress dashboard, click on "Plugins," then click "Add New." 3. In the "Add Plugins" page, click "Upload Plugin." 4. Click "Browse," then choose the zip file you downloaded. 5. Click "Install Now." 6. Click "Activate." 7. You should see a new "NarraFirma" menu item in your dashboard menu. Click it. 8. In the screen that appears, create a new project and add some users who can access it. == Frequently Asked Questions == = Where can I found out more about participatory narrative inquiry? = Take a look at the book behind NarraFirma, [Working with Stories in Your Community Or Organization: Participatory Narrative Inquiry](http://www.workingwithstories.org) = What should I do if I find a bug? = Tell us about it on the [GitHub issues list](https://github.com/pdfernhout/narrafirma/issues). = What about web security? = We strongly suggest that you set up any web site on which you intend to install NarraFirma with SSL (secure sockets). Your hosting provider should be able to help you do that. == Screenshots == 1. This is the main page of NarraFirma. The sections of the software (and the phases of PNI) are shown in the diagram. Clicking on any of these buttons leads to that section. 2. This the main page for the NarraFirma planning section. Links to all the pages in that section are listed. You can enter reminders for any page; they show up on this page. 3. Here the NarraFirma user is describing the groups of people who will be participating in their project. Describing your groups helps you think about how you should collect stories and what you should do with them. 4. Here the NarraFirma user is doing a little sensemaking exercise based on some stories they told about what might happen when they do the project. Thinking in stories during project planning helps to make better decisions about how to carry out the project. 5. Here the NarraFirma user is deciding how they will collect stories. They are looking at recommendations the software is giving them based on the answers they gave to the questions about their participant groups (see screenshot 3). 6. Here the NarraFirma user is creating questions they will ask people about their stories. 7. Here is the NarraFirma survey form participants see when they tell their stories (or NarraFirma users see when they enter the stories they collected off-line). 8. Here the NarraFirma user is looking at stories as they come in to the collection. They are looking here only at stories told by older people who said the person in their story wanted to be heard. 9. Here the user is looking at patterns in the data (answers to questions) collected. The selected row of the table of patterns (at the top) shows that the questions "How do you feel about this story" and "What is your age" are being compared, creating a contingency (bubble) graph. The user has written an observation about that pattern ("People under 35 more positive") and two interpretations of what that pattern might mean ("More weight on older shoulders" versus "Younger people have lots of energy"). The user has selected some stories on the graph to read; the stories appear in the table at the bottom of the image. 10. Here the NarraFirma user is designing a plan for a sensemaking session, where people will work with the collected stories and patterns to make sense of the topic being explored. 11. Here the NarraFirma user is ansewring questions about the outcomes of the project for each participant group. Those outcomes will determine recommendations for interventions. 12. Here the NarraFirma user is reflecting on the entire project, to learn from it and to keep good records for the future. == Changelog == = 1.2.2 = Added: Can now run pre-import check and export story form from "Design story forms" page (so you no longer have to create a story collection to do these things) Fixed: Bug where import scale range value of 0 was being ignored Fixed: Bug where story form name was not being set properly Fixed: Bug where newly created question did not have id field set, resulting in an error when you replaced it during import of story form = 1.2.1 = Added: Option to graph multi-choice questions against themselves (to explore coincidences between answers) Changed: Changed "vs" to "x" in graph names, to read better in languages other than English Changed: Increased font size of axis labels (they seem too small now that the graphs are a little bigger) Changed: Made sure graphs of every type have a title at the top; gave title a class; styled it Fixed: Bug where observations-only report did not include observations without the strength value set = 1.2.0 = Added: Many new import options to accommodate/manage/massage CSV data files from a variety of surveying systems Added: Detailed guide to importing data Added: All CSV import options are now specifiable in NarraFirma itself (instead of only through a specification file) Added: Data consolidation (lumping together similar answers) using CSV import Added: Pre-import data check to verify CSV data integrity before actually adding stories to project Added: New graph type - choice by choice by scale, or a contingency table with little pseudo-histogram boxes Added: Added story length question (generated) to graphs Added: Table of links in catalysis report to observations and interpretations for each perspective (sorted by strength) Added: Filter to limit catalysis report to subset of stories based on answer(s) to question Added: Option to print catalysis report with observations only (for group catalysis workshop) and with only particular strengths Added: Option to hide graphs with few stories (applies to multiple histograms/scatterplots on Explore patterns page and catalysis report) Added: Ability to save catalysis report graphs in SVG format rather than PNG (better resolution and can be styled with CSS) Added: Ability to refer to portion of observation name as well as text using @header@ system Added: Button on Explore patterns page to show stories selected in graph (for copying) Added: CSS classes for named elements in catalysis reports (to style particular perspectives, observations, and interpretations) Added: Filter to limit story cards to subset of stories based on answer(s) to question Added: Choice of question sort order when printing story cards: alphabetically or in story form order, with scales separate or mixed in Added: Option to truncate very long stories when printing story cards Added: CSS classes to style particular question names and answers in story cards Added: "Quick links" on home page to access elements of projects (questions, forms, reports, etc) Added: Method to reset (empty out) project, removing "hidden" stories connected to deleted story collections (project admin only) Added: Button to display names of deleted story collections (so you can get them back again, or avoid doing so) Added: Method to archive (hide) old projects (site admin only) Changed: Moved around some buttons and pages in Collection to make it more clear how/where to import and export data Changed: Improved names of graph types on configure catalysis report page (to make it clear why would want each one) Changed: Project import now requires administrator permission (so does new reset function) Changed: Project import now warns user if there is data in the project (questions, forms, collections, reports) Changed: Link to site administration page (formerly called "Administration tool") is now visible only to site administrator (and is now on Home page) Changed: Improved design, organization, explanations of site administration pages in both node.js and WordPress versions Changed: Improved layout of catalysis report pages for multi-graph results Changed: Stress tested with 13K stories; works fine, though slowly (may need increased memory setting at these numbers) Fixed: Bug where "admin" project permission was not being set properly in node.js version (but it was not being used for anything) Fixed: Bug where creating new project with long name in WordPress version caused 500 server error (now name length is restricted to <= 20 characters) Fixed: Bug that caused spurious error messages during report generation Fixed: Bug that caused spurious error messages about missing IDs when creating story forms Fixed: Bug in bar graphs for boolean questions ("no" was being counted as a non-answer) Fixed: Bad handling of missing/empty custom CSS in imported story form file Fixed: Navigate-in-page "name" anchors changed to "id" anchors (because "name" anchors are deprecated in HTML 5) = 1.1.0 = * Added: Optional summary of submitted stories and other data, for participants to copy and save * Added: Human readable project report with all data entered for use outside of software * Fixed: Bug in login link = 1.0.2 = * Added: Notes for questions, to keep track of decisions made while choosing and editing questions * Fixed: All user communications in the survey can now be customized (essential for non-English surveys) = 1.0.1 = * Fixed: Made navigation bar (at top) not scroll (was accidentally made scrolling) * Changed: Updated WordPress screenshots for new version = 1.0.0 = * Added: New data integrity graphs showing overall patterns across all questions (all scale values; per-participant means and sd; number of non-answers) * Added: User definable CSS for on-line and printed surveys, story cards, catalysis report * Added: Qualitative (free-text) answers in catalysis patterns * Added: More user definable fields to customize on-line story collection * Added: Multiple scatterplots to show scale+scale+choice question combinations * Added: Link to choose another project without logging out * Added: Visible slider number (0 to 100) and way to set value precisely * Added: Option to set maximum number of stories participants can tell * Added: Story count per participant (framed as a "question" so it can form patterns with other questions) * Added: Auto-create story form option (using all existing questions) * Added: Can now choose which questions to include on story cards * Added: More control over the look of story cards, including custom CSS but also which questions to include and how to draw ranges * Added: Ability to set all story form options during CSV import * Added: Way to distinguish among participants during import (to count stories per participant) * Added: Scale conversion during import (for scale data collected with ranges other than 0-100) * Added: Field to write (then copy and paste) reminders from Return phase of one project to Planning phase of the next * Added: Way to choose types of graphs to view * Added: Counts above bars in bar graphs and histograms * Added: Correlation lines (optional) in scatterplots * Added: Mode to histograms * Added: Support for multiple observations per pattern (graph) * Added: Observation strength field to sort strong from weak patterns * Added: Interpretations to patterns list (can sort by them) * Added: More options for catalysis graphs including histogram bins, scatterplot dot size and opacity * Added: More user-supplied sections for catalysis report * Added: Unanswered count (number of stories with no answer to the question) to all graphs * Changed: Improved data import, with better error handling and help * Changed: Overhaul of screen designs and color palettes * Changed: Improved statistical information displays; improved reporting on statistical errors * Changed: Better error reporting and alerts to user * Changed: More tips and FAQ items to help system * Changed: More verification of statistical result against same tests in other software (you can't see this but it's important) * Changed: More help in various places to deal with questions people have had * Fixed: Explore Patterns page now shows cancelable progress bar when large numbers of statistical results are being calculated * Fixed: Bug in chi-squared statistical calculation that disqualified too many comparisons * Fixed: Survey image now works * Fixed: Text areas now slightly taller * Fixed: Catalysis "ideas" now print in report * Fixed: Catalysis clustering diagram now updates better for changed interpretatations on previous page * Fixed: No longer showing questions in graphing sections (spot-check graphs, catalysis) that are not used in current story collection * Fixed: Eliciting question now included in spot-check graphs and catalysis * Fixed: Better graph sizing and scaling * Fixed: Statistical results no longer say "p=0.000" when p<0.001 * Fixed: Better feedback when taking survey, showing that story has been submitted and accepted * Fixed: Better error handling for missing or untitled items (like story collections and catalysis reports) * Fixed: Dividing line (hr) no longer displays on story cards when they are being printed = 0.9.8 = * Added clarifying headers and popup hints for all links on dashboard (project phase) pages. * Improved styling and clarity of catalysis report, printed story form, and story cards. * Added story count to Spot-check graphs screen. = 0.9.7 = * Fixed bug in checkbox questions where data was not being stored correctly. * Improved colors, labels, spacing of graphs. * Added story counts to Review stories and Explore patterns screens. * Added "does not apply" check box (configurable) to slider questions. * Improved help on question types. * Improved look of story card display. * Moved annotations to top of Review stories list; colored in green so they stand out. = 0.9.6 = * Sanitize SQL input in WordPress plugin. * Improve TypeScript typings for tsc 1.6. = 0.9.5 = * Improvements for Node.js version and README/SETUP for installation. = 0.9.4 = * Now uses NarraFirma namespace in WordPress plugin PHP to conform with WordPress guidelines. * Fixed WordPress plugin survey bug where always returning first questionnaire added in a topic instead of the last one. = 0.9.3 = * Fixed problem where first two characters of display name are being truncated during CSV export of story form. * Added arrows to sliders in survey form to make it more useful in narrow mobile displays. * Added warning about story collection creation. * Fixed some typos. = 0.9.2 = * More improvements to bundling of JavaScript for faster loading. Also improved startup feedback to show loading application, getting user information, or retrieving project data. = 0.9.1 = * Improvements to bundling of JavaScript code for faster loading. = 0.9.0 = * This is the first publicly released version of NarraFirma. For (highly detailed and entertaining) change logs, see the [GitHub repository](https://github.com/pdfernhout/narrafirma). == Upgrade Notice == = 1.2.2 = This minor upgrade copies a few buttons (important to importing data) to some more useful places. It also fixes a few annoying bugs. = 1.2.1 = This minor upgrade adds the option to graph multi-choice questions against themselves, to look for patterns in coincidences of answers. It also improves a few visual details and fixes a bug in the observations-only catalysis report. = 1.2.0 = This higly recommended upgrade improves catalysis reports and story cards, and provides many more import options. It also includes many usability improvements and small bug fixes. = 1.1.0 = This upgrade adds two new ways to get your data out of NarraFirma: in the survey, a summary of submitted stories participants can copy and keep; and in the application, an HTML project report that summarizes everything you typed into NarraFirma (for use in other software). = 1.0.2 = This minor upgrade improves your ability to control messages in the story form (especially useful for non-English surveys). It also adds a "notes" fields to each question, so you can keep track of your reasons to use particular questions. = 1.0.1 = This upgrade fixes a small bug in the NarraFirma interface. It also improves the screenshots shown in the WordPress plugins directory. = 1.0.0 = This highly recommended upgrade improves customization of surveys and reports, plus better support for narrative catalysis (finding and exploring patterns). It also includes many usability improvements and small bug fixes. = 0.9.8 = This upgrade improves the clarity and style of the application and some of its reports. This is not a critical release, but it's recommended because it makes the application easier to use. = 0.9.7 = WordPress users should upgrade to this version. It contains a fix for a bug that could lose data in checkbox survey questions. A "Does not apply" option was added for slider questions. There are also some improvements to graphs and usability. = 0.9.6 = WordPress users should upgrade to this version as it contains a security fix. = 0.9.5 = Improvements for Node.js version and README/SETUP for installation. There is no need to upgrade to this version for WordPress users. = 0.9.4 = This upgrade fixes a bug where the web survey always used the first version of a question form and would never disable it. It also uses a NarraFirma namespace in the WordPress plugin PHP file to conform with WordPress guidelines. = 0.9.3 = This upgrade fixes a bug (in CSV export) and a few cosmetic issues. = 0.9.2 = This upgrade affects loading time, and there is a small cosmetic change. = 0.9.1 = This upgrade affects performance only. == Donations == We have spent a lot of time developing NarraFirma. We appreciate donations, and will use them to keep working on it. You can donate at [PayPal](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=DGVVDT2D49QA8). == Need some help? == I offer training in the use of NarraFirma and consulting for PNI projects. If you are interested, check out my web site at [cfkurtz.com](cfkurtz.com), or send me a note at cfkurtz at cfkurtz dot com.