Freemed-YiRC V1.20

From FMYiRCWiki

Jump to: navigation, search

Freemed-YiRC V1.20

This is the primary page for all information relating specifically to version 1.20 of Freemed-YiRC.


What is Freemed-YiRC V1.20?

FMYiRC V1.20 is the third official/stable release of Freemed-YiRC. This version has been tested extensively and is intended for general use. For more information about what Freemed-YiRC is, please see About FMYiRC.

Download Files - What You'll Need

  • If you are installing Freemed-YiRC for the first time (i.e., from scratch), then you need to follow the NEW INSTALL section below.
  • If you wish to upgrade an existing V1.00 installation, then you need to follow the UPGRADE section below




  • There are three different methods you may use to get Freemed-YiRC installed and running. YOU ONLY NEED TO FOLLOW ONE OF THESE METHODS! If you don't understand the differences between these methods, please follow METHOD #1.
    • METHOD #1: RECOMMENDED - Use Mandriva Linux 2007.1 with the Freemed-YiRC Helper CD (in .ISO format)
      • First, you'll need to download and install Mandriva Linux 2007.1. It is very big, it does not fit on one CD. In fact, it no longer fits on three CDs, so now it comes as a DVD image. This means you will need a DVD burner to create the install DVD if you intend to download it. You will also need a DVD reader drive on the machine you intend to install Freemed-YiRC. You can also choose to support Mandriva Linux and purchase a boxed edition.
      • Second, you'll need to download the Freemed-YiRC Helper CD:
      • For this method, please refer to the Freemed-YiRC V1.20 MDV2007.1 Installation Manual
    • METHOD #2: - Use Mandriva Linux 2007.1 with the Freemed-YiRC Helper CD (in .tar.gz format)
    • METHOD #3: - USE ONLY IF YOU ARE HIGHLY FAMILIAR WITH LINUX! - If you are using a version of Linux other than Mandriva Linux 2007.1, or you do not wish to use the Helper CD




  • If you wish to upgrade an existing Freemed-YiRC V1.10 installation, then you can use the Freemed-YiRC V1.10 to V1.20 upgrade program.
    • NOTE! This upgrade program ONLY works with installations of Freemed-YiRC V1.10! If you have any other version than V1.10, you will not be able to use this upgrade program!!!
    • NOTE! This upgrade program ONLY updates the FMYiRC source code & database. This upgrade program does not include other operating system packages which may be necessary to use some of the new functionality added in V1.20.
    • NOTE! If you are currently running Freemed-YiRC V1.10, but you've modified any of the files from the original stock version, this upgrade may replace those files!!! The upgrade program creates a backup of all replaced files. If you fall into this category and you wish to use the V1.20 upgrade, you may have to synchronize your modifications with the new V1.20 files where applicable. This may be a very large task if you've made a lot of modifications!
    • NOTE! As is always the case, MAKE A BACKUP OF YOUR SYSTEM BEFORE APPLYING THIS UPGRADE!!! In addition, you may wish to test this upgrade using a copy of your live system (files & database) and apply the upgrade to that copy.
    • Download: freemed_yirc-V1.20_upgrade.tar.gz (0.3MB)

  • How to apply the upgrade (This must be done as a superuser!):
    • Place the freemed_yirc-V1.20_upgrade.tar.gz file in the /tmp directory.
    • Uncompress the file.
      • cd /tmp
      • tar -xzvf freemed_yirc-V1.20_upgrade.tar.gz
    • Go into the newly created V1.20_UPGRADE directory
      • cd V1.20_UPGRADE
    • Run the program
      • ./
    • If the program encounters any show-stopping errors, it will notify you up front before actually applying the upgrade.
    • If there are any errors during the upgrade, two text files will be created: errors1.txt and errors2.txt. Check these files for details.
    • Any files replaced in your existing Freemed-YiRC install will be placed into the V1_10_UPGRADE sub-directory of your Freemed-YiRC directory.



Major Changes From V1.10


Base System

  • Keyboard navigation shortcuts/hotkeys!
    • Users can now use Alt key combinations to navigate quickly to certain parts of Freemed-YiRC. For more information, please see the keyboard shortcuts article. This is selectable per user via the My Preferences menu option at the bottom of a users main menu.
  • Major core code upgrades. A lot of work has gone into updating some of the core Freemed-YiRC source code, as parts of this date back to 1999. A major focus of this has been to prepare for the future release of PHP version 6.
  • Support for Internet Explorer 8.
    • The newest version of the Microsoft Internet Explorer web browser attempts to adhere much better to established web standards. However, in order for it to do this properly, web application designers have to explain to Internet Explorer 8 that their application expects IE8 to do this properly! Freemed-YiRC V1.20 does this and should reduce and/or eliminate any issues users who were using Freemed-YiRC with IE8 were having (i.e., premature session ending, being logged off).
    • All agencies and users are still highly encouraged to switch to a web browser which has much better support for web standards such as Mozilla Firefox.
  • The Group Menus now have a selected resident option.
    • Previously, if you were to switch between modules on a given group menu but were still working with information relating to the same resident, you had to select that resident's name each time you entered a module. No longer! Freemed-YiRC V1.20 introduces the ability to select a resident right on the group menu. Then, when entering a group menu module which relates to specific residents, the resident selection screen will be bypassed. For users upgrading from Freemed-YiRC V1.10, this may require changing a new module setting (group_menu_use_selected_res).


  • Added a new Trash folder. Any deleted e-mails will be automatically placed into this folder and automatically removed 30 days after an e-mail has been deleted.


Other Changes From V1.10



  • Added a new feature to allow users to change their own passwords.
    • This is done via the new module setting allow_users_pass_chgs for the User Administration module. This is Enabled by default. If you do not wish to allow users to change their own passwords, this can be set to Disabled
    • Users can changes their own passwords by accessing the My Preferences link at the bottom of their main menu.

Contact Database

  • Dates integration with the User Calendar 2 module.
    • Dates entered into the Dates section for Staff contacts (and also newly for Resource contacts too) can be set up to generate calendar events and/or e-mail alerts via the User Calendar 2 module.
  • Added the ability to break down resident census per diems into Title IV-E Maintenance and Administration categories.
    • This must be enabled by changing the new module setting enable_perdiem_iv_e_breakdown to Enabled.
  • Added the ability to add a Per Diem for foster parent pay calculations.
    • This must be enabled by changing the new module setting enable_fos_par_perdiem to Enabled.
    • The actual ability go generate a report showing foster parent pay info did not make it into Freemed-YiRC V1.20. It will be included in a future release. However, this will allow you to start collecting this information.
  • Added the ability to automatically inactivate contacts (Residents/Resources/Staff) if they have been marked as terminated for a certain number of days.
    • This must be enabled by changing the new module setting auto_inactivate_after_dot to something greater than zero. This number is the number of days AFTER a person is terminated (Date of Termination) that they will automatically become inactivated. It is recommended this be no lower than 30-45 days. This allows for final documentation and reporting to be created.
  • Added the ability to temporarily re-activate contacts which have been marked as inactive.
    • This can be done in the same location where you'd edit a contacts name and/or status.
  • Added a new user Security Database permission to restrict access to sensitive areas of the Staff section of the Contact Database (Demographics, Accounting, and Salary Sheet).
    • This is the Access Staff - HR Info permission in the Contact Database section of User Administration - Security Permissions for a user.
  • Added new sections for Resource Contacts in the Contact Database:
    • Prospective Tracking
    • Internal Investigations
    • Abuse/Neglect Investigations
    • Training Hours
  • Added new sections for Resident Contacts in the Contact Database:
    • ADD ONs. - This lists any children a resident may have.
    • NOTES - For generic notes on a resident.
      • This must be enabled by changing the new module setting enable_res_notes to Enabled.
      • Level of Care - This is used to keep a history of Level of Care changes.
    • Service Plan Info
      • NOTE: This section is intended to record information to be used by the new Report Generator module, which may not make it into version V1.20.
    • Medbill Self Pay Rates - This is used by the MedBill module.
      • NOTE: The functionality may not be in place in V1.20 to make use of this information yet via the MedBill module.
  • Modified the process of adding a new contact to double-check existing contacts for first name/last name matching. This is helpful in situations where a contact may be inactive and someone tries to re-create them, creating a duplicate contact.
    • Also modified the process for resident contacts to check Social Security Numbers to ensure there are no duplicates there.
  • Added a new report in the Contact Database - Staff Pay Rates Report.
  • Modified contact types Resident, Staff, and Resource to display a warning if they are active and NOT associated with a group. This is very important, and sometimes a frustrating/confusing aspect for new Freemed-YiRC users, as unless a contact is associated with a group, they may not show up on reports and/or data entry screens.
    • Also, modified to check and ensure that one group is marked PRIMARY.
    • Also, modified Resource contacts to display an error if they are not associated with a Resource Location.

Contact Database Reports

  • Modified to add many more fields relating to all contact types.
  • Added the ability to generate CSV (Comma Separated Values) export files from reports.
    • This allows the ability to import these files into things like Open Office or Microsoft Word/Excel to create custom reports.

Calendar (User Calendar 2 / Group Calendar 2)

  • Added the ability to import calendar events using the iCalendar format.
    • NOTE: This feature may not adhere 100% to the iCalendar format, you must perform small-scale testing to ensure it works the way you expect it to.

File Storage

  • Added the ability to move files between folders.
  • Added the ability to upload multiple files at once.
    • This must be enabled by changing the new module setting pload_files_num to a value greater than zero.

Incident Report System

  • Added new module for IRS-Reports - This contains several reports useful for Incident Reports.

Ohio Scales

  • Major revamping of the Ohio Scales main menu.
  • Added new report - Changes Over Time - Integrated
  • Added new report - Changes Over Time - Ind. Questions

Phone & Vistation Log

  • Added ability to specify a contact from the Contact Database for the Visitor/Contact name.
  • Added ability to do batch entry of records.
    • This must be enabled by changing the new module setting enable_batch_entry to Enabled and changing enable_batch_entry_number to a value greater than zero.
  • Added ability (via module setting) to print individual PVLs (after creation and from PVL menu).
    • This must be enabled by changing the new module setting enable_ind_note_printing to Enabled.
  • Added ability to link PVL entries with a Domain/Client Need. This list comes directly from the Service Plan Goals (SPG) Module list of domains
    • This must be enabled by changing the new module setting enable_spg_domainlist to Enabled.
  • Modified the PVL system to import dates from the Clinical CaseNote System.
    • This can be disabled by changing the new module setting enable_alt_ccn_import.
    • The category name for imported records can be changed by changing the new module setting alt_ccn_import_catname.
    • Non-billable CCNs can be imported too by changing the new module setting ccn_import_nonbill_too to Enabled.

Resource Locations

  • Added a warning to display when a location is not associated with a group. This is very important and can be confusing/frustrating for new users of Freemed-YiRC. All Resource Locations MUST be a member of at least one group!

Training Hours Menu

  • Modified to allow Resource Contacts to be included now.
  • Modified so the person who presented the training can be added at the same time as the attendees. Previously this required two different passes through the same data entry screen to accomplish.


Complete List of Changes

  • For a complete list of changes from V1.20, you may check out the V1.20 TODO page.
  • This page is now complete (i.e., is no longer a TODO list), and can be used as a complete technical reference for all changes from V1.10 to V1.20.
  • This can be quite helpful for programmers who may have a modified version of V1.10 and wish to custom-implement some of the V1.20 changes.



Please see the Documentation page! In addition to the Installation Manual for the chosen installation method above.



Freemed-YiRC V1.20 was released on July 22nd, 2010



Personal tools