save<\/code>funci\u00f3n.<\/p>\n![\"C\u00f3mo](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-151739-61e4cecf0099f.png\")
<\/a><\/p>\nEsto sucede porque WordPress compara el bloque guardado en la base de datos con el c\u00f3digo actual en la save<\/code>funci\u00f3n de su bloque y no coinciden. WordPress no puede reparar la diferencia. En la mayor\u00eda de los casos, puede hacer clic en los tres puntos del bloque y elegir "Intentar recuperaci\u00f3n del bloque". Si los cambios realizados en la save<\/code>funci\u00f3n fueron peque\u00f1os (por ejemplo, un cambio de clase), WordPress puede restaurar el bloque. En el peor de los casos, usted Necesito hacer clic en "Convertir a HTML" y perder\u00e1 la edit<\/code>funcionalidad de su bloque. Obviamente, no podemos esperar que los usuarios de nuestro c\u00f3digo de bloque encuentren manualmente todas las publicaciones que usan este bloque y realicen estos pasos para cada una.<\/p>\nEntonces, antes de realizar actualizaciones a la save<\/code>funci\u00f3n, agregaremos un c\u00f3digo para decirle a WordPress c\u00f3mo manejar el contenido antiguo que se guard\u00f3 con la save<\/code>funci\u00f3n anterior.<\/p>\n\u00a1Entremos en el c\u00f3digo!<\/h2>\n
En realidad es bastante simple. En resumen lo que tenemos que hacer es; agregue una deprecated<\/code>propiedad a la registerBlockType()<\/code>llamada de funci\u00f3n. Esta propiedad espera una matriz. Eso significa que puede desaprobar un bloque varias veces, proporcionando m\u00faltiples entradas en la matriz. Cada depreciaci\u00f3n se define como un objeto que contiene la attributes<\/code>propiedad completa y la funci\u00f3n (antigua) save<\/code>.<\/p>\nEn otras palabras, define una deprecated<\/code>propiedad como una matriz y luego copia su bloque attributes<\/code>y save<\/code>funci\u00f3n en ella. Deber\u00e1 incluir atributos aunque no cambie nada en ellos en la actualizaci\u00f3n. No necesita incluir la edit<\/code>funci\u00f3n en la depreciaci\u00f3n.<\/p>\ndeprecated: [\n {\n attributes: { ... },\n save: (props) => { ... }\n }\n]<\/code><\/pre>\nVeamos esto en un ejemplo m\u00e1s pr\u00e1ctico.<\/p>\n
Supongamos que nuestro c\u00f3digo de bloque se parece a esto. La edit<\/code>funci\u00f3n se excluye porque no necesitamos tratarla en la depreciaci\u00f3n.<\/p>\nconst { __ } = wp.i18n;\nconst { registerBlockType } = wp.blocks;\nconst { RichText } = wp.blockEditor;\n\u00a0\nimport edit from '.\/edit';\n\u00a0\nregisterBlockType( 'awp\/deprecated-block-example', {\n title: __( 'Example of deprecating a block' ),\n icon: 'format-aside',\n category: 'widgets',\n attributes: {\n alignment: {\n type: 'string',\n default: 'center'\n },\n exampleString: {\n type: 'string'\n },\n },\n edit,\n save: (props) => { \n const { exampleString } = props;\n return(\n <div className=\"deprecated-block-example\">\n <RichText.Content value={ exampleString } \/>\n <\/div>\n );\n }\n});<\/code><\/pre>\nEntonces supongamos que queremos hacer cambios en ambos atributos y guardar y evitar romper bloques existentes. Agregamos la deprecated<\/code>propiedad y copiamos todo attributes<\/code>y save<\/code>como un elemento de matriz en ella. Entonces somos libres de hacer cualquier cambio en la funci\u00f3n attributes<\/code>or\/and save<\/code>.<\/p>\nconst { __ } = wp.i18n;\nconst { registerBlockType } = wp.blocks;\nconst { RichText } = wp.blockEditor;\n\u00a0\nimport edit from '.\/edit';\n\u00a0\nregisterBlockType( 'awp\/deprecated-block-example', {\n title: __( 'Example of deprecating a block' ),\n icon: 'format-aside',\n category: 'widgets',\n attributes: {\n alignment: {\n type: 'string',\n default: 'center'\n },\n exampleString: {\n type: 'string'\n },\n newThing: {\n type: 'string'\n },\n },\n edit,\n save: (props) => { \n const { exampleString, newThing } = props;\n return(\n <div className=\"deprecated-block-example\">\n <RichText.Content value={ exampleString } \/>\n <div className=\"new-content\">\n <RichText.Content value={ newThing } \/>\n <\/div>\n <\/div>\n );\n },\n deprecated: [\n {\n attributes: {\n alignment: {\n type: 'string',\n default: 'center'\n },\n exampleString: {\n type: 'string'\n },\n },\n save: (props) => { \n const { exampleString } = props;\n return(\n <div className=\"deprecated-block-example\">\n <RichText.Content value={ exampleString } \/>\n <\/div>\n );\n },\n }\n ]\n});<\/code><\/pre>\nCon este c\u00f3digo compilado, puede ir a buscar una publicaci\u00f3n existente utilizando el c\u00f3digo de bloque anterior, \u00a1y no deber\u00eda obtener ning\u00fan c\u00f3digo roto!<\/p>\n
WordPress se dar\u00e1 cuenta de que el bloque est\u00e1 usando nuestro c\u00f3digo obsoleto y cargar\u00e1 el contenido usando el save<\/code>c\u00f3digo obsoleto. Una vez que realice cambios en el bloque y actualice la publicaci\u00f3n, el bloque se guardar\u00e1 con la nueva save<\/code>funci\u00f3n.<\/p>\nDepreciaci\u00f3n m\u00e1s avanzada y lecturas adicionales<\/h2>\n
El ejemplo de c\u00f3digo anterior es la forma m\u00e1s b\u00e1sica de depreciaci\u00f3n. WordPress admite m\u00e1s funciones, como incluir migrate<\/code>e supports<\/code>incluso asignar constantes (piense en n\u00fameros de versi\u00f3n) a su c\u00f3digo obsoleto. Eche un vistazo a la documentaci\u00f3n de WordPress sobre la depreciaci\u00f3n de bloques<\/a>.<\/p>\n