Contrib.social

Add advice for how to upgrade from the Drupal 7 version to the 2.1.x and newer versions.

Open on Drupal.org →
Created on 15 January 2025, 3 months ago

Problem/Motivation

There isn't currently any advice on this module's project page for how to upgrade from the Drupal 7 version of this module to the current version (2.1.0 right now).

Steps to reproduce

Proposed resolution

Add some advice to the project page in order to help people navigate the upgrade.

I took the liberty of collaborating with Chat GPT to create this small guide.

<h2>Upgrading from the 7.x-1.5 version to a 2.1.x version.</h2>

<p>When upgrading from the Drupal 7 version of the User Expire module to the Drupal 8/9/10/11 version, several new features and improvements are available in version 2.1.0 and greater.</p>

<h3>Key enhancements include:</h3>
<ul>
  <li>
    <strong>Configurable Warning Email Timing:</strong> Administrators can now define the time period between when a user's account is set to expire and when the warning email is sent. This feature, introduced in response to 
    issue 
            
              #3261317: Force a delay between notification and user expiration →
            , offers greater flexibility in managing user notifications.
  </li>
  <li>
    <strong>Customizable or Disabling Email Notifications:</strong> The module now allows you to customize the warning email content or disable the notification entirely. This ensures you can tailor the messaging to fit your site’s needs or omit it if email notifications are not required. See 
            
              
              
              ✨
              Disable or customize expiration email
                Needs work
              
            
 [#]
  </li>
  <li>
    <strong>No Longer Requires the Date Contributed Module:</strong> In Drupal 7, the User Expire module relied on the Date contributed module. However, starting with Drupal 8, the module takes advantage of the <code>datetime

form field type provided by Drupal Core, eliminating the need for additional dependencies.

  • Migrating User Expiration Dates:
    • If you need to migrate user expiration dates from your Drupal 7 site, this can be done using the Migrate module. You’ll need to create custom Migrate source and destination plugins to handle the data transfer.
    • If you believe such functionality should be included directly in the module, please open an issue on the User Expire issue queue → to discuss this feature request.
    • Alternatively, you can manually copy all user expiration settings from your old site to your new site.

    • When upgrading from 7.x-1.5, review your current settings and update the configuration in the 2.1.x version to take advantage of these new features. Be sure to test the email notification functionality and make any necessary adjustments to align with your site’s requirements.

    Remaining tasks

    Publish

    User interface changes

    API changes

    Data model changes

    💬 Support request
    Status

    Active

    Version

    2.0

    Component

    Documentation

    Created by

    🇺🇸United States trackleft2 Tucson, AZ 🇺🇸

    Live updates comments and jobs are added and updated live.
    Sign in to follow issues

    Comments & Activities

    contrib.social Blog FAQ Discussions
    Production build 0.71.5 2024