Sintaxis de ALTER TABLE con dbDelta

Has usado incorrectamente la función dbDelta.

El propósito principal de esta función es pasarle un comando SQL de creación de tablas.

Si la tabla no existe, la crea.

Si la tabla existe pero no coincide, se modifica hasta que coincida. Esto incluye agregar y actualizar columnas, índices y otros aspectos.

Por lo tanto, lo que debes hacer es ejecutar dbDelta y proporcionarle tu SQL de creación de tabla, no SQL de alteración de tabla.

Consulta aquí la documentación del Codex sobre cómo agregar una actualización/alteración a una tabla usando dbDelta

¡Pero hay más! dbDelta es una función exigente, no puedes poner cualquier sentencia SQL allí, debe estar formateada apropiadamente

Esto es lo que dice el Codex en la misma página:

1. Debes poner cada campo en su propia línea en tu sentencia SQL.
2. Debes tener dos espacios entre las palabras PRIMARY KEY y la definición de tu clave primaria.
3. Debes usar la palabra clave KEY en lugar de su sinónimo INDEX y debes incluir al menos una KEY.
4. No debes usar apóstrofes o backticks alrededor de los nombres de los campos.

Y de otra fuente:

Función dbDelta

Como mencioné antes en uno de mis artículos, la función dbDelta tiene la capacidad de examinar la estructura actual de la tabla, compararla con la estructura deseada y agregar o modificar la tabla según sea necesario, por lo que puede ser muy útil para actualizaciones de nuestro plugin. Sin embargo, a diferencia de muchas funciones de WordPress, dbDelta es la más exigente y problemática. Para que la función dbDelta funcione, se deben cumplir algunos criterios.

1. Tienes que poner cada campo en su propia línea en tu sentencia SQL.
2. Tienes que tener dos espacios entre las palabras PRIMARY KEY y la definición de tu clave primaria.
3. Debes usar la palabra clave KEY en lugar de su sinónimo INDEX y debes incluir al menos una KEY.

Bueno, los criterios anteriores parecen fáciles de lograr. Pero espera a que te golpeen.

• http://hungred.com/how-to/wordpress-dbdelta-function/

Para agregar una columna a alguna tabla de WordPress en la base de datos, puedes usar $wpdb para ello:

global $wpdb;

$table = $wpdb->prefix . 'my_table';
$sql = "ALTER TABLE `{$table}`
        ADD `new_column` VARCHAR(20) NULL DEFAULT NULL;";

$query_result = $wpdb->query( $sql );

$wpdb->query() devuelve false si tu consulta falló, según la documentación del método. Así que podrías escribir una declaración if-else para hacer algo en caso de éxito o error:

if ( $query_result === false ){
    // ocurrió un error
} else {
    // éxito
}

Si necesitas agregar tu nueva columna después de una columna específica, simplemente usa AFTER en la consulta:

$sql = "ALTER TABLE `{$table}`
        ADD `new_column` VARCHAR(20) NULL DEFAULT NULL
        AFTER `exist_column`;";

También podrías modificar

$sql = "ALTER TABLE `{$table}`
        MODIFY COLUMN `exist_column` VARCHAR(20) NULL DEFAULT NULL;";

o eliminar una columna

$sql = "ALTER TABLE `{$table}`
        DROP COLUMN `exist_column`;";

Un pequeño tip: En PHP, dentro de comillas dobles ("), puedes usar variables entre llaves ("foo {$var} bar") o sin ellas ("foo $var bar") para insertar variables en cadenas, en lugar de concatenación ("foo " . $var . " bar"). Lo uso en el código anterior. Aprende más sobre el análisis de cadenas en php.