Een beginnersgids voor Titan Framework een datumtype-optie toevoegen

In dit artikel zullen we de datum type optie in Titan Framework: hoe het werkt en welke parameters het biedt. Ontdek hoe u een datumkiezer kunt maken in een aangepast WordPress-beheerdersdashboard, een metabox of een customizer-gedeelte.

De datumtype-optie in Titan Framework

In Titan Framework is er een datum type optie waarmee eindgebruikers de datum- en tijdinstellingen dynamisch kunnen invoeren in hun thema's. Met deze optie wordt de volledige kalender geladen en kunt u elke gewenste datum instellen. Hier is de lay-out van deze optie:

Laten we eens kijken naar de lijst met parameters die deze optie ondersteunt:

  • naam: Definieert de weergavenaam van de datum type optie.
  • ID kaart: Deze parameter specificeert een unieke naam die helpt om de opgeslagen waarden te krijgen.
  • desc: Het geeft een korte beschrijving weer met de naam van de optie.
  • standaard(Optioneel) Hiermee wordt de standaardwaarde ingesteld datum instellingen. Deze parameter neemt een specifiek formaat van waarden op, d.w.z.. Y-m-d voor de datum, Hoi voor de tijd, en Y-m-d H: i voor zowel datum als tijd.
  • datum: (Optioneel) Als vals, deze optie wordt niet getoond. Het is ingesteld op waar standaard.
  • tijd: (Optioneel) Als waar, deze optie verschijnt. Het is ingesteld op vals standaard.

De parameters datum en tijd zijn boolean op type, terwijl de rest van het type zijn draad

Beschikbare containers voor de optie Datumtype

De datum type optie kan binnen gemaakt worden: 

  • Administratie Paneel
  • Admin-tabbladen
  • Metabox
  • Thema Customizer-gedeelte

Deze optie wordt gemaakt door een vergelijkbare coderoutine te volgen, ongeacht het containertype:

  • Krijg een uniek exemplaar via de getInstance () functie.
  • Voeg een optie toe via de createOption () functie.
  • Verkrijg de opgeslagen waarden via de GetOption () functie. 

Als u echter wilt weten hoe deze containers met Titan Framework worden gemaakt, kunt u de details in mijn vorige artikelen in deze serie vinden.

Een datumtype-optie maken in een beheerdersdashboard

Voorbeeldverklaring

Eerst maak ik dit optietype aan in een beheerdersvenster.

createOption (array ('id' => 'aa_date', // De ID die wordt gebruikt om de waarde van deze optie te krijgen 'type' => 'datum', // Type optie we maken 'naam' => 'Mijn datumoptie', // Naam van de optie die wordt weergegeven in het adminpaneel 'desc' => 'Dit is onze optie', // Beschrijving van de optie die wordt weergegeven in het beheerdersvenster 'standaard' = > '2015-8-15' // Standaardwaarde));

EEN datum type optie wordt aangemaakt in een admin paneel $ aa_panel via de createOption () functie (regel # 7). Ik heb de parameters gedefinieerd id, type, naam, desc en standaard. De ID (d.w.z.. aa_date) moet altijd uniek zijn. 

U kunt zien dat de genoemde optie Mijn datumoptie bestaat in een admin panel Nette opties. De standaard datuminstelling wordt ook weergegeven in de bovenstaande schermafbeelding. 

Voorbeeldgebruik

Laten we de opgeslagen optiewaarden ophalen.

getOption ('aa_date'); // Converteer de datum van de echografische waarde van de datum van de datum ('r', $ aa_date_epoch_val); // output als RFC 2822-datum - geeft lokale tijd terug - Lees voor meer informatie http://goo.gl/g9tZLi?> 

In regel # 3 wordt een exemplaar verkregen via de getInstance () functie, die een unieke parameter vereist, bij voorkeur je themanaam (die ik heb gebruikt netjes). De opgeslagen waarden worden opgehaald via de GetOption () functie in regel # 6, die de ID registreert aa_date als een parameter en slaat de waarde op in een nieuwe variabele $ aa_date_val.

Het laatste deel van de code drukt waarden af ​​aan de voorkant. In de meeste gevallen kan de server ons een epoch-waarde retourneren, die we moeten converteren met behulp van PHP's datum() functie. Het bespreken van epoch-waarden valt buiten het bestek van deze tutorial, maar u kunt hier meer over lezen.

Resultaat weergeven aan de voorkant

Nu zal ik elke demodatumwaarde instellen en opslaan. Ik kies er bijvoorbeeld voor 2015/08/20.

Laten we de uitvoer aan het front-end bekijken.

De opgeslagen datuminstelling is correct afgedrukt, met de tijd. Als de parameter voor tijd is nu uitgeschakeld, er worden geen tijdsinstellingen weergegeven. Hoe stel je de tijd in? Ik kom daar een beetje op terug.

Een datumtype-optie aanmaken op een beheerders-tabblad

Voorbeeldverklaring

Nu zal ik deze optie toevoegen aan een admin tab, maar het zal beide tonen datum en tijd instellingen.

createOption (array ('id' => 'aa_date_in_tab1_panel2', // ID's moeten altijd uniek zijn.De ID die wordt gebruikt om de waarde van deze optie te krijgen 'type' => 'datum', // Type optie we zijn aanmaken 'naam' => 'Mijn datum optie', // Naam van de optie die getoond wordt in het admin paneel 'desc' => 'Dit is onze optie', // Beschrijving van de optie die getoond wordt in de admin paneel 'default' => '2015-8-15 00:00', // Standaardwaarde voor datum & tijd 'tijd' => true // Tijdinstellingen ingeschakeld.)); 

Deze keer voeg ik een toe datum typ optie in een admin tab $ aa_tab1. Zijn ID is aa_date_in_tab1_panel2. Kijk naar de lijst met parameters. Het laat zien tijd ingesteld op waar. Dit betekent dat de tijdselectie is ingeschakeld. Let op de waarde-indeling voor standaard, die is ingesteld voor beide datum en tijd.

Je kunt vinden Mijn datumoptie in Tab 1van het admin panel Nette opties 2.

Voorbeeldgebruik

Laten we de waarden ophalen.

getOption ('aa_date_in_tab1_panel2'); echo datum ('r', $ aa_date_in_tab1_panel2_val); // output als RFC 2822-datum - geeft lokale tijd terug - Lees voor meer informatie http://goo.gl/g9tZLi?> 

Er is echt niets nieuws in deze code.

Resultaat weergeven aan de voorkant

Stel dat mijn demodatum en tijdwaarden dat zijn 2015/09/06 en 08:45. Er is ook een Nu knop waarmee de huidige tijdwaarde met één klik wordt ingesteld.

De voorkant ziet er als volgt uit:

Een datumtype-optie in een Metabox maken

Voorbeeldverklaring

Laten we de code schrijven.

createOption (array ('id' => 'aa_mb_date', // ID's moeten altijd uniek zijn.De ID die wordt gebruikt om de waarde van deze optie te krijgen 'type' => 'datum', // Type optie we zijn aanmaken 'naam' => 'Selecteer Tijd Instellingen', // Naam van de optie die getoond wordt 'desc' => 'Dit is onze optie', // Beschrijving van de optie die 'default' => 'getoond wordt 00:00 ', // Standaardwaarde voor tijd' datum '=> false, // Datuminstellingen uitgeschakeld.' Time '=> true // Datuminstellingen ingeschakeld.)); 

De createOption () functie voegt een toe datum type optie in een metabox $ aa_metbox (regel # 5). Maar deze code wordt alleen weergegeven tijd instellingen omdat het datum is ingesteld op false. Dat is waarom ik de. Heb veranderd naam en standaard waarden van deze optie dienovereenkomstig.

Bovenstaande schermafbeelding toont een tijdkiezer met de naam Selecteer Tijdinstellingenin een metabox. Dit verschijnt op alle pagina's en na bewerkingsschermen.

Voorbeeldgebruik

Laten we de opgeslagen tijdwaarden ophalen.

getOption ('aa_mb_date', get_the_ID ()); echo datum ('r', $ aa_mb_time_epoch_val); // output als RFC 2822-datum - geeft lokale tijd terug - Lees voor meer informatie http://goo.gl/g9tZLi?> 

Ik heb zojuist de waarde van tijd opgehaald en deze vervolgens geconverteerd met de datum() functie.

Resultaat weergeven aan de voorkant

Mijn demotijdwaarde is 13: 03.

De uitvoer wordt als volgt afgedrukt:

Een datumtype-optie creëren in een thema-aanpassergedeelte

Voorbeeldverklaring

Uiteindelijk zal ik deze optie toevoegen in een themaaanpassingsgedeelte.

createOption (array ('id' => 'aa_sec_date', // ID's moeten altijd uniek zijn.De ID die wordt gebruikt om de waarde van deze optie te krijgen 'type' => 'datum', // Type optie we zijn aanmaken 'naam' => 'Selecteer datum / tijd instellingen', // Naam van de optie die getoond wordt 'desc' => 'Dit is onze optie', // Beschrijving van de optie die 'standaard' wordt getoond = > '2015-08-01', // Standaardwaarde voor datum en tijd 'datum' => true, // Datuminstellingen ingeschakeld. 'Time' => true // Tijdinstellingen ingeschakeld.)); 

Ten slotte heb ik deze optie toegevoegd volgens dezelfde procedure in een themaaanpassingsgedeelte.

Het screenshot laat het duidelijk zien.

Voorbeeldgebruik

Laten we de opgeslagen optiewaarden ophalen.

getOption ('aa_sec_date'); ?> 
Waarde van datum / tijd is

Ik zal de opgeslagen waarden in de header.php het dossier. Dus, krijg eerst een instantie en registreer de unieke ID in de GetOption () functie. Maak vervolgens een div en print de uitvoer van de variabele $ aa_sec_date_val via de datum() functie (regel # 13).

Resultaat weergeven aan de voorkant

Hier is een screenshot van de veranderingen die plaatsvinden.

Conclusie

Op deze manier kunt u dynamische datum- en tijdinstellingen toevoegen aan uw WordPress-thema's en -plug-ins. Deze optie kan handig zijn wanneer u wilt dat de eindgebruiker de datum en tijd invoert om welke reden dan ook. 

Ik was bijvoorbeeld bezig met het opbouwen van dit WordPress-thema, waar ik een aangepast berichttype wilde toevoegen (via een plug-in). Op dat moment had ik de mogelijkheid om een ​​van de meest gebruikte Event-plug-ins toe te voegen of zelf een nette kleine plug-in te coderen. 

Dus in plaats van mijn klant te voorzien van een gebeurtenis-plug-in die mogelijk op de cockpit van een vliegtuig leek, heb ik Titan Framework gebruikt. Ik gebruikte de datum typ optie twee keer in twee verschillende metaboxen voor afspraakdatums.

Integreer deze optie in uw project en verminder de last van het schrijven van lange code. In mijn volgende artikel zullen we de radio- type optie in Titan Framework.

Heb je nog vragen? Plaats ze in de reacties hieronder of neem contact op met Twitter.